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Now, both of these indispensable tools 
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world's most advanced operating system. 
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systems administration applications for the Mac OS. 
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http://www.ttmbuktupro.com 


netOctopus 

Intuitive and powerful, netOctopus can manage a network of ten or 10,000 
computers. Inventory computers, software and devices on your network; distribute 
software; configure remote computers; and create custom reports on the fly. 
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Want to enhance the performance 
of FileMaker Pro on MAC OS X? 
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Information Liquidity: a highly 
profitable state where all of 
your information is transformed 
into real economic value. 
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world-class security and the 
ability to handle thousands of 
transactions per minute. It'll 
also give your users the power 
of SQL queries. 


A FREE Developer's Edition 
download is available online 
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Xcode and Code Completion 


This month, we're going to take a look at Xcode's code 
completion feature. As you’ll see, code completion is much like 
the liehavior you see in your browser when you start typing a 
URL and the browser does its best to save you the keystrokes by 
filling in the closest match it can to complete the URL, But 
Xcode’s code completion is much more tlian that. Follow along 
and you'll see what I mean. 

As we've done for the past few months, we'll work with the 
Sketch sample project. As a reminder, tlie Sketch fQes live in 
/Dcn/eloper/Examples/AppKit/Sketch/. Before you open Sketch, 
make a copy of it. We will he breaking it! 

Launch Xcode and open your copy of die project 
SketchphxproJ, 

SmiNG Code Completion Frees 

Before we dig into code complelion itself, let's take a 
look at the code completion preferences. Select Preferences 
from the Xcode menu, then click on the Navigation icon in 
the scrolling pane at the top of the Preferences window 

(Figure 1). 
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Figure h Xcode Preferences, the Naingaiion Pane. 


Your very First course of action is to make sure the Enable 
Indexing checkbox is checked. The Enable Indexing checkbox 
tells Xcode to coastantly index your projea in the background as 
changes are made. An updated index Is what makes project 
searches so lightning quick. Since the index Is maintained in the 
background, the overhead is hardJy noticeable. If you turn 
indexing off, code completion, search, and anything else that 
depends on the index will slow considerably. Alternatively, if 
you have a very large project that was never indexed, you might 
not want to turn on indexing if you just have a few small changes 
to make. No sense waiting for the index to be built if you won’t 
be taking advantage of it. In general, 1 always start off with 
indexing turned on. 

Next step, check the Enable Code Completion checkbox. 
Obviously, this enables code completion. 

There are a series of checkboxes and radio buttons that are 
enabled once you enal^le code completion. The fust of these, 
Automatically suggest matching option, is what does the auto- 
cfjmplete as you type. For example, il' the constant greenColor 
w^as the only symbol in scope that started with a g, you might 
type g and Xcode might add a grey reenCalor. 

When there is more than one symbol in scope that matches 
the current typing, Xcode will build a list of all tlie matching 
options. This is called the option list. As you type, if there is 
more than one matching symbol, Xccxle will display a grey 
ellipsis (...). Anytime you see this ellipsis, you can hit the Code 
Sense Complete key (see Figure 2 for the Code Sense Complete 
key binding - the default is F5) and the option Qsi wall popup 
allowing you to select from a list of matching options. 

The Automatically popup option list checkbox is a bit of a 
puzzle to me. The sense 1 get is that this option controls whether 
the option list popup appears wlienever you start typing a 
symbol and there is more than one match, ff the checkbox is 
unchecked, you have to type E5 (or whatever the Code Sense 
Complete key binding is set to) to bring up the popup. If that is 
tlie case, tlien this option is broken, as it behaves the same 
whether this checkbox is checked or not. I've got a question in 
to Apple on this, but haven't heard back yet. I'm guessing this is 
a bug and will be fixed in the next Panther release. 


Dave Mark i.s a long-time Mac developer and MacTech contributor. Author of more than a dozen books on various Mac-developmcnt topics, Dave is 
all al-)out Xcode these days. Last month's column took the debugger through a few of its paces. This month's installment will focus on code completion. 
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The next item in tlie prefa dialog is the Tab key selects the 
current item checkbox. It allows the tab key to both bring up 
the option fist popup and make a selection from the popup. I 
Find this option intuitive. Play with it, both on and off, but I'd 
definitely leave it checked. 

Next is the Contains only items matching word checkbox. 
If checked, the option list popup will contain only syml:>ols that 
exactly match w'hat you've ty^ped so far. If it is unchecked, the 
list wUl contain matcliing items and then a few more, either 
before or after the matching items in the symtol list. Play with 
this and you’ll see what I mean. 

Next is a radio button set labeled Option list shcm^s 
methods/functions as: with buttons for Name only and Name 
and arguments. This option set lets you specify whether 
methods/functions listed in the option list popup are listed just 
by name, or with arguments. 

The next radio button set, Completed metbod/function 
inserted as.\ lets you specify whether the selected 
method/function is inserted in your code as just the name or 
with argument placeholders. 

The rest of the Navigation prefs pane lets you determine 
what types of symbols are included in the editing 
window's function popup and whether the function 
popup is sorted alphabetically or by the order the 
symbols appear in the source file lx;ing edited. 

Well take a look at some examples that should make all 
the.se options a bit clearer. But first, well take a quick look at 
the key bindings prefs. 

Changing the Key Bindlng 

You can change most, if not all of the key bindings that ship 
with Xcode. Go to the Xcode menu, select Preferences..., then 
click on the Keyf Bindings icon, Now click on the Text Keyf 
Bindings tab (Figure 2.) 
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figure 2 Changing the Code Sense Complete keyf binding. 
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NoteBook can find. 
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NoteBook. We think 
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The text key bindings are sorted into functional sets, like 
Text Editing, Cursor JHovement, and Text Fonnatting, each with 
its own disclosure triangle. Open the Text Editing triangle. 
Under the c's, you^ll find Code Sense Complete. In the Keys 
column, you should see the key binding To change this to 
some other key, double-click on the f5. Assuming you are 
playing with your bindings for the first time, you'll see the dialog 
shown in Figure 3* 



The key brnding set "XcQde Oefeuir is 
owned by the system 

IF you vti^h to edit it. you muic first make a cofry 


Cantei ) f Make Copy ^ 


Xcode Default 

Compatible 

MetroWefk&mi Campattble 
MPW(R) Compatible 



Figure 4. The key^ hindmg sets that ship with Xcode, 


The key binding labeled Code Sense Completion List pops 
up the option list, even if there is only a single item on it. More 
imponantly, die key binding labeled Code Sense Argument 
Placeholder Seleci jumps to the next argument placeholder in 
your just completed code. We'll demo this is a minute. 

Add a key binding for this one. Double-click in the 
column to the right of Code Sense Argument Flaceholder Select. 
When the edit field appears, type in your key binding, Most 
folks use control-slash (A/) for this one. 


Figure i Making a Imwrmi copy of the Xcode key binding set. 

Click Make Copy to create your own copy of the the Xcode 
key bindings. 1 named mine Dais's Bindings. Make all the 
changes you like to those, then use the popup menu ai the top 
of the pane, labeled Key Binding Sets, to select Xcode Defauli 
(See Figure 4), if you ever need to go back to the original 
settings. Ytm’ll also find built-in key sets for BBEdiC 
CodeWarriof; and MPW. 


stockicons.com 

brought to you by the Iconfactory 


Icons to go! 

.j. 4 j Lj u±; m 

o o s ca 0 a y 

tsJow de\/elopers can purchase complete collections 
□f professionally designed icons at an affordable 
price from tive premier source for custom designed 
icons in the industry. See some of the work we have 
done for Apple, Microsoft, Aladdin. Intuit, Palm and 
many otf lers at wvwv iconfactoiydesign.CDm. 

Each stixk icon cdlection contains 80 mdtvifiual 
icons In three pixel sizes - 32x32, 24x24 and I foci 6. 
Collections aie untfiiije in ai id are piovded in 
an aifdy oi formats indixiing transparent TIFFs. 

Gtr, PNG. .cns, and WirxJows format co's. 

For more infomiation visit www.stockicons.cQm. 


Taking Code Completion For A Spin 
Let's take a quick louk ai code completion in action. I'm 
editing the file SKTGraptlc.m in the Sketch project. Remember 
to make a copy of the project IxTore you mess around with it, 
just so you don't break it, 

I'm going to add this line of code to the project; 

[self setBoundsiNSMakeRect[0.0. 0.0. 1.0, 1.0}]i 

Since we're not concerned with com[)ihng this code, feel 
free to type tiiis line anywhere you like. Start at the beginning 
of a new line by typing the beginning of the line: 

[self setBounds-NSMake 

Note that I typed NSM in all caps, as (opposed to nsm. This 
is because I liave the Matches using case-sensilivity checkbox 
checked in tlie Navigation prefs. 

Figure 5 sliows w here we are at tliis point. Notice the ellipsis 
( .. J that follow's the NSMake, telling us that theie are some matcliing 
options. If there w'as tmly one, the option would Ix.^ filled in in grey. 


©ee SKTCrapNk.m _ O 


^ • 

e P 

a m 

Guild Rurt D<bug ik 

Help Groups 

Editing Mode Prpjeci 

Sketch lUpgradedl 

^ ► |SKTGrapbic.fd;20 ; 

-\m ; 

% 1 #,! 


// m™«™=i^============i==^^==^nii=3iia Initioi izoUon 


- (td)tnU { I 

setf d [super irrltli 
if <stlf> { 

.docunent - niUtnit 

[self setOoundsiWSflakej, - i 

[$e I f setF i U □= lor: pJSCo lor g ] ]; 

[self setOrowsfiUiYES]; 

[self setStrokeCclor.'PitSColor blockColor]]; > 

[self set£)rQws:Stroke:YES]; 

[self set3trokeLineildtli:l,0]; 

Figure 5 . Tl^e start of NSMakeRect code completion. 
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Now press F5 or tab to bring up the option list popup. 
Figure 6 shows the popup with the Contains only items 
matching word checkbox checked. 1 pressed the arrow key 
twice to select NSMakeRect, then pressed tab to add 
NSMakeRect, and its argument placeholders, in the code. 

WSPoint NSHakePoint(floot x^float y) 

NSRange NSMc]KeRQnge(unsignect int loG,unsign€ 
NSRect NSHakeRect(f Lodt x,float y^float w,fl 
NSSlze N3MakeSize(floot w,float h) 

Figure 6, The option list popup for NSMake. 

Here's the code at tfiis point: 

[self eet^ounds:K3HQkeRect(dlff loot xSfe-j^toat 

y^,<#ftoat w#>,<#flGat h#>) 

Note that each argument is marked by a placeholder 
between matching angle brackets and p<mnd signs. The four 
arguments are w, and h. The first placeholder is selected. 1 
want the first argument to be I type it, then press control- 
slash (A/) to select the next placeholder: 

[seif setBounds:N3MdkeRect(0,0,<ifloot y#>,<#float 
loot nife.) 

I continue typing aig^uments and pressing t\/ ^intil my 
statement is complete: 

[seLf setBounds:NSHakeRect(0-0,8,0,1,6,1,6); 

Tiu. Next Month.*, 

[ really like this method of argument selection. It works well 
for me, As you've seen over the last few^ months, the [tiove from 
Project Builder to Xcode is a quanrum leap fomard. 1 really like 
the attention to detail, such as the depdi of preference settings 
on the Code Sense and Ke)> Bindings panes. And you just know 
that as much as compilation performance has improved from 
Project Builder to Xcode, there are dramatic improvements still 
to come..,© 
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MAC OS X 

PROGRAMMING 

SECRETS 


By Scott Knaster 

Building a System Preference Pane 


Most applications include a Preference item in their 
application menu that lets users tweak the way things work* In 
fact, the very program I'm using to type these words includes a 
vast set of preferences with over 100 settings divided into ten 
categories. Even the Finder includes its own preferences. 

Sometimes, little bits of software need to have 
preferences, but are not substantial enough to easily provide 
a user interface for them. These can include parts of the 
system, such as the Dock or the built-in Screen Effects, or 
cool third-party utilities. In Mac OS 9, users often tweaked 
these settings in control panels. As with so many things, the 
preferences world has changed radically since ihose bygone 
days. Mac OS X provide.s a System Preferences application 
that includes preference panes for these asssorted but 
important system settings. 
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Figure System Preferences winclow. 

OS X conies with a hunch of preference panes used hr 
system settings, as you can see in Figure 1, But in addition, 
System Preferences (since OS X 10.1, anyway) provides a plug¬ 


in framework that you can use to create you own preference 
panes that appear in the System Preferences window right 
alongside the system^s built-in panes. 

For [his month's column, Fm borrowing code and the 
concept from Joe Zobkiw’s cool new book, Mac OS X Advanced 
Development Techniques. This book provides real code and 
information about a nifty collection of OS X topics, including 
applications, system services, multiple threads, and more. If you 
want to read a fun, well-written book diat will broaden your 
knowledge of OS X programming topics, check It out. 

They Thought of This 

For our sample in this column, we'll create a simple preference 
pane called BigPane that has a checkbox and a text field. To gel 
started, crank up Projed Builder and choose New Project from the 
File menu. When you get the New Projea Assistant, take a look 
under tiie Standard Apple Plug-ins section. Hey, there's a project 
type called PreferencePane! By choosing that one, we get a projea 
that's already hcM^ked up to the preference pane fiamework. We'll 
go ahead and create our new preference [TAne projea. 


W ^ ^ 



Figure 2. New, empty preference pane project .. 


Once the project has been created, we can move forward 
w'idi the primary task of writing the code, 'fhe empty project 


Scott Knaster lias lieen writing about Macs for as long as theie Imve been Macs* Scott's books Htjw To W'rite Macintosh Sojhifare and Macintosh 
Progmmming Secrets were required reading for Mac programmers for more than a decade. Scott wrote developer bcroks for General Magic and worked on 
Mac software for Microsoft. Scott's books liave lieen translated into Japanese and Pascal. Scott has every issue of Mad maga2:ine, which explains a lot 


10 


Building a System Preference Pane 


MacTech • November 2003 



























declares BigPanePref, a subclass of NSPreferencePane. Tlie 
listing foDows: 

^interface BigPanePref : E^SPreferencePane 

i 

CFStringRef m_apprD: //our application ID 

IBOutlet NSButton *Tn_checkBox: 

IBOutlet NSTextPleld *in_textPlEld: 

] 

- (IBActionJcheckboxClicked:(idjsender; 

@end 

Here we"re simply declaring the class, including a string to 
hold the application II) so we can find our preferences file, 
references to the controls that are included in the pane, and the 
checkBoxClicked action that we'll implement. 

First Things First 

Getting into the actual code, the first thing well deal with is 
overriding initWithBundie, which is called when the preference 
pane starts up, 

rt ” HyP r e fer en c e PanePr e f. h " 

1 erne nt at ion My P r e f e renc e Pane? re f 

- {id)ln±tWlthBiindle:(flSBundls *)bundle 
// System Prefercnets calls this method when 

// the pane is initialized. 

t 

// Initializje the location of our preferences 

if ((self “ [super initWithBundie:bundle]) 1= nil) ! 


m.appID = CFSTR{"coin*knaster-bigpane'"} : 

I 

return self; 

] 


This override gets us the appID, which we'll use to locate the 
file that preferences are stored in. You should use a filename that 
Ls unlikely to be the same as any other file, and is named after the 
application or sendee whose preferences it contains. Also, 
because this is an init method, Apple says we should be good 
citizens and call the inherited implementation, which we do. 

Once the view is created and the nib file is loaded, our 
mainViewDidLoad method will be called This is where we get a 
chance to initialize the preference controls with their saved values: 


- (void)mainViewDidLoad 
t 

CFPropertyListRef value: 

// Get tlie value of tlie dieckbox from the saved prefs 
// (if any) 

value ^ CFPreferencesCDpyAppValue 
(GFSTR ("Boolean Value Key"'), HLappID) : 

if (value && CRGetPypeID(value) “ CFBooleanGetTypelD()3 

[ 

[ia_checkBox setState: GFBooleanGetValue (value) ] ; 

] else [ 

[EUcheckBox setState:NOl: 

//'riira it off if wc cani find a saved Miitit 
) 

if (value) CFKelease(value); 

// Gel die contents of the text field 

value ^ CFPreferencesCopyAppValue 
(CFSTRC'String Value Key") . nuappID): 

If (value && CFGetTypelD(value) “= CFStringGetTypelD(}) [ 

[m_textField setBtringValue:(NSString *)value]: 



End the compromise 

with perfect quality and file size. 


Produce highly compressed, lossless QuickTime videos for delivering screen 
capture training videos, animated text and graphics. 


JecinSmith 




Try it FREE today at www.techsinith.com 



Video Codec 









} else I 

[m^tej^tField setStriogValue:®’'"] : 
if Mnit the string empt)' if there's no sav-ed value 
1 

if (value! CFlelease{value): 


In oor override of mainViewDidLoad, we get the values of 
our two preferences (a checkbox and a text field, remember) from 
the file. We're getting some help from the cool Core Foundation 
Preference Services here. We call CFPreferencesCopyAppValue 
to get the values out of the file, and w'e use CFGetTypelD to 
ensure the values are valid. If not, we set tlie controls to defiuilt 
values. Continuing in our quest for good citizenship in case w^e 
have to run for governor some day, we release the value objecLs 
when we don't need them any more. 


Preparlng for the Invasion 
Now that the pane is up and running and the controls have 
their values loaded, what happens when the user starts changing 
stuff? If the user clicks on the checkbox, we'll get a 
checkboxCiicked message, so we'll override that method to 
change the associated preference at the same time: 

- (iBActlon)checkboxCiicked:(id)sender 

I 

if ( [sender state] ) 

CFPrefereiicesSetAppValue[CFSTB(*'Boolean Value 
kCFBoalGanTtue, appID ): 
else 

CFPreference3SetAppValue{CFSTR{'"Boolean Value key"*] , 
kCFBooleanfalse. appID )^ 


In this method, we're simply setting the value of the 
preference based on the state of the checkbox. We use the 
handy CFPreferencesSetAppValue call from Core Foundation 
l^reference Services. Why tion'i we save the value the text 
field this way, too? We could, by watching for various NSText 
messages, but it's prol>ably sufficient just to save the text fiekl 
when the user is done widi the pane, whicli we'll do in 
didUnselect, coming up next. 

Can you believe we're almost finished writing the code for 
our little sample? All that's left is the implementation of the 
didUnselect metJiod: 


- (void)didUnselect 

//The system calls didl'nseiea when smother pane is 
// (jpening or the user quim System Frefertnees. 

1 

CFRotificatlonCenterRef center; 

// Save ilie value in tlie text field 
// to our preferenceii fUe. 

CFPreferencesSetAppValue(CT’STRt"String Value Key”), 
InutestField strlugValuej, tii_appID) * 

a Make the hie is flushed and its etmtents written 
if to disk. 

CFPref erencesAppSynchrorLixe (m_appID): 

// Broadcast a notification that preferences have 
// changed, In case Big Bn^ther is watching, 
center = CFKotificationCenTerGetDistributedCenter0: 

CFNotificationCenterPDstNotification(center, 

CFSTR(”Preferences Changed”), m_appn), MIX. TRUE): 

I 


The main wT>rk of Uie didUnselect override is to save tlie 
conicnLs of the text field to our prefs file, which we do by oiUing 
CFPreferencesSetAppValue and CFPreferencesAppSynchronize. 
Also, we call CFNotificationCenterPostNotification to send a 
notification to any interested code that our prefs have changed - 
probably, nobody cares, but you never know. 

More Details 

Putting together the nib file and finishing the project are 
pretty straightfon\^ar<.f Using Interface Builder, just place the 
controls you're using - in this case, our check box and text field 
- in the window provided by the project. Figure 3 shows how^ 
this looks in Interface Builder. 



figure 5. Ow preference pane in Interface Builder 


Of cTuirse, w hen yt^u're making your ow n preference pane, 
just arrange tlie controls and other u.ser interface elements 
howxwer you like. You can even add a tal>bed view (NSTabView) 
to the window and place controls in multij*>Ie tabs. Your code 
dex'sn't know^ ttr cure which tab contains a particular control. 

Another neat trick is to add your own custom 32 by 32 pixel 
Finder icon for the pane. You can do this by putting your icon 
into the project's aiff file - in tmr example, that would be 
BigPaneUiff. 'Hiis file is automatically created by ProjeetBuilder 
vvitli the default light swatch icon. 

If you're building a prelerence pane as part of a real project, 
you'll want to include the pane in your in.staller, llie pane 
should go into -/Librafy/PrelerencePanes. when youYe just 
[practicing, you can drag the preference bundle there and install 
it yoursell’. If tlie System Preferences application is running, quit 
it and am it again. You should see your new^ preference pane 
listed in the "Other" glieito at the U)tiom of the screen if you're 
viewing by c-aregtjry. and in proper alphabetical order otherwise. 
Note tliat you can't place your pane into an existing category, 
nor can you create new categorie.s. Bummer. Maybe that ability 
will come m a future version. 

Summing Up 

This covers the basics of creating a sy.stem preference pane, 
■SO you should now' be able to go forward with your plans for that 
awesome system seivice or odier minimahUI widget. If you want 
to learn more about this topic, or many other related cool OS X 
tricks, please check out Mac OS X Advanced Development 
Techniques, written by Joe Zobkiw and pubtislied by Sams 
Publishing Developer's Library. See tittp://www.triplesoft.com/nnacQSx/ 
to find out more. 
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UniTAniCLINC 
THE WEB 


By Kevin Hemenway, Statutory Relevance 

Enabling the Embedded: PHP 


We’ve covered CGI scripts, but how is 
PHP any better? 

In the pa.st five mondis, weVe mmed on our buik-m 
Apache web server, fiddled with the quick and dirty Server Side 
Includes (SSI), configured CGI to run scripLs written in languages 
like Perl, Python, and Ruby (see also Jim Menard's article on 
Ruby, MacTecb, March 2003) and, in general found that this 
high-falutin’ web serving stuff ain’t all that difficult. However, 
we’ve yet to launch into a peaceful meandering of PHP, one of 
the easiest and more popular programming languages available 
for web development. 

In the first of assuredly many self-congratulatory, pointless, 
and cliched ''personal milestone" articles, our amazing, exciting, 
over-the-top, and action packed sixth entry will.,, will.,, welp, 
it'll reach you about configuring and customizing PHP with your 
Apache web server. Quick, over there! Bearded lady! Vegas pole 
dancer! Scarily painted clown! 

But First, The Who... Oh, Look! Historical References! 

As most developers know, it's hard to talk afiout a language 
without getting into religious wars (“my recursively-named i.s 
better tlian your yet-another!’’), personal dislikes (“whitespace!'! I 
can't believe F)Thon considers it syntax!"), and programming 
theory (“procedural is to OOP as that's odd' is to ‘eureka’!"). 
Regardless, there is one clear advantage to using PHP under 
Apache: “forking" (or rather, the lack thereof). 

See, anytime a CGI script is requested, Apache forks (or 
spatms) a new process to handle this request, and then 
executes the code within this newly created environment. This 
happens pretty quickly and without fuss or muss, but with one 
downside: every lime a proce,ss is spawmed, the interpreter (be 
it Perl, Python, Ruby, etc.) has to be reloaded into memory— 
nothing is remembered or cached from previous runs. The 
more and more times this happeas (due to hea\’y incoming 
traffic, for example), the slower the web server will get; Apache 
will spend more time waiting for prtx;esses to finish than 
actually serving their results. 


This doesn’t happen with Apache's Server Side Includes. 
Since SSIs are built into the web server via a default module 
called mod_inciudes, everything is handled internally and no 
forking is required. This same approach is used witli die 
mod_php module: by preloading PHP into each and every 
Apache process, you remove the need for the forking and 
interpreter loading overhead. The only downside is slightly larger 
memory, a trade-off worth taking. 

Let’s see how mod_php Ls configured within Apache. 

Fnabung The PHP Module Within Apache 

As you'll see, configuring PHP under Apache is very similar 
to what we've seen in our previous articles—this stuff should be 
old hat to you by now. As we’ve been doing from the start, to 
find out more about a feature, we’ll search for the keyword 
within the httpd.conf file. Our first matches for THP" are our 
familiar LoadModule and AddModule lines: 

LoadModule php4_iiiodule lib&xee/httpd/libphp4.so 

AddHodiile inDd_php4, c 

Similar to our previous articles, these two uncommented 
knes (j.e., not prefaced with a # diaracier) load die module 
located at /usr/iibexec/httpd/libphp4.so into our Apache web server. 
You may notice that the module name doesn’t match what we’ve 
grown to expect (modjncludes for Server Side Includes, mod_cgi 
for CGI scripts, etc.), as it's called libphp4.so instead. There’s 
nothing special about dus... everyone calls it mod_php regardless 
of w'hat the actual file representation is. 

Our next “PHP" search researdi should also look familiar: 

-# 

#Tcj use PHP files: 

# 

AddType applicalion/x-httpd-php .php 
AddType appiication/x-httpdphp-source -phps 

Similar to Server Side Indudes, diese two lines tell files 
ending with a php or phps extension to become associated with 
the PI IP module. You’ll notice there'.s no AddHandler equivalent 
like with SSI or CGR largely, diat’s {>ecause die “application ” of 
die MIME-type instructs mod_php to become their ''handler". It's 


Kevin Hemenway, coaullior of Mac OS X Hacks and Spidering Hacks, is better known us Mortius Iff, the creator of disobey.com, which bills itself as 
Vxintent for the discontemed," Publisher and developer of more home cooking than you could ever imagine (like the pfjpular open-sourced aggregator 
AmphetaDesk, the best-kept gaming secret Gamegrene.conn, the ever ignorable Nonsense Network, etc.), he’s trying desperately to find time to work on 
liis next liook outline. Soon, he says, sot>n. Contact him at morbus@disobey.com. 


14 


Enabling the Embedded: PHP 


MAdTECH • November 2003 











Multiple formats. Multiple platforms. 
Complex installers. 

Aladdin solves the compr^sum and imtallatim puzzle. 


Trying to figure out how to handle multiple 
compression formats and platforms? 

The Stuffit Engine solves the compression puzzle. 

Aladdin’s Stuffit Engine SDK: 

> Adds value to your application by integrating powerful compression and encryption. 
>■ Is the only tool that supports the Stuffit file format. 

> Provides a single API that supports over 20 compression and 
encoding formats common on Macintosh, Window's, and Unix. 

>• Makes self-extracting archives for either Macintosh or Windows. 

>• Available for Macintosh, Windows, Linux, or Solaris. 


Licenses start as low 
as $99/year 

To learn more, visit: 
www.stuffitxom/sdk/ 



stuffit Engine SDK' 

The power of Stuffit In your software. 



Looking for the easiest and fastest 
way to build an installer? 

Stuffit InstaUerMaker completes your puzzle. 


It’s not enough just to write solid code anymore. You still have to write an installer 

for your users. Stu ffi t InstaUerMaker makes it simple and effective. 

>• Stuffit InstaUerMaker gives you all tiie tools you need to instaU, uninstaU, 
resource-compress or update your software in one complete, 
easy-to-use package. 

>• Add marketing muscle to your instaUers by customizing 
your electronic registration form to include surveys 
and special offers. 

>• Make demoware in minutes. Create Macintosh 
OS X and Macintosh Classic compatible installers 
with Stuffit InstaUerMaker. 

Stuffit InstaUerMaker 

The complete Installation solution™ 


Prices start at $250 

To leant more, visit: 
w^AW-stuffit-com/ 
installemiaker/ 


.^^^Aladdin 
w\Systems' 

www.stuffltcom 
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sc3rt of like Adobe Acrobat Reader handling .pdf files (which 
have a MIME-type of applicatlon/pdf L If youVe already designed 
your entire site around .html hies and doni feel like revamping 
your structure or redirecting old URLs, you can modify the first 
line like so: 

AddType application/x'httpd’php .plip .btntl 

This will enable support for PHP ccxle in both .php and .html 
files. Be careful not to go nuts with this: you don t w^ant to add 
lile extensions "just because’". Whether you actually use PUP 
code within mi .html file or not, mod_php will process it like you 
did, and that can unnecessarily slow down your server when 
your traffic starts getting heavier. 

With that, weVe run out of search results in our httpd.conf— 
PHP has already been configured for our use. But how^ do we 
kncjw for sure, besides attempting to run some PHP code and 
introducing varying levels of user error? To find out w^hich third’ 
party modules are loaded into your w^eb serv^er, check Apache’s 
error_log wLere, for evety^ startup, the "server tokens” wall be 
logged. These tokens reflect the server version number, what 
operating system ifs running cjn, and information on w'hich 
third-party modules have been loaded. 

Since w'e’ve been searching for ‘PH}^’ throughout the 
httpd.conf, let's do the same widi our error_log. Figure 1 show's 
the results of a grep PHP /var/log/httpd/error_log shell command, 
listing the server tokens each restait of our Apache ser\'er 
logged grep is a great tool for quickly searching a file from the 
command line. 
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Figure 1: Cnpping our envrjog for Apache s nen^ tokens. 


Now that we know PHP is enabled, let’s learn more by 
w riting our first script. 

Far More phpinfoO Then Yoi^ve Ever Wanted 
Since PHP has been enabled for any file that ends with .php, 
weTe going to create a test.php file within our personal user 


directory (/Library/iisemama/SItes/). The contents of this file will 
be simply: 

<7 phplnfot); ?> 


Any PHP code you WTite will need to be sandwiched 
within a starting and ending delimiter, <? and ?> in this 
example. You may also see and use starting delimiters like 
<?php (often recommended for greater portability over the 
shorter <?), and <?= (wliich can be used to quickly echo a 
variable or expression). With our delimiters in place, w^e1l use 
one of PHP’s built-in functions, phpinfo(), to spit out gobs of 
information about our installation. Figure 2 shows partial 
output of http://127,0.0 J/~username/teslphp’ 
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figure 2: The first page ofphpinfoiys many. 


Obviously, there’s a ioi cjf stuff here, and a good portion of 
it won t be immediately (or even ever) useful, but there are a 
number of interesting things to discover. HI touch briefly on a 
few of the more helpful entries below, but you can alw'ays find 
out more by searching tlrrough the online documentation at 
http://www.php.iiet/. 

• The first section w'e come acrrjss gives us the version 
number of PHP (w'hich we previously saw in die output of 
our error_log), the time the module wais built, and more 
importantly, the configuration line used to build ic 7'his 
becomes he!phi 1 if we ever build our own version of the 
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“Without a doubt^ the Premiere Resource Editor 
for the Mac OS ... A wealth of time-samng tools 

- MacUser Magazine Eddy Awards 

‘A distinct improvement over Apple's ResEdit ” 

- MacTech Magazine 

“Every Mac OS developer should own a copy of Resorceren'' 

- Leonard Rosenthol, Aladdin Systems 

“Without Resorcerer, our localization efforts would look like a ^ 

Tower of Babel. Don't do product without itr 

- Greg Galanos, CEO and President, Metrowerks 

“Resorcerer's data template system is amazing." 

- Bill Goodman, author of Smaller Installer and Compact Pro 

“Resorcerer Rocks! Buy it, you will NOT regret it" 

- Joe Zohkiw, author of A Fragment of Your Imagination 

“Resorcerer will pay for itself many times over in saved time and effort." 
-MacUser review 

“The template that disassembles PICT's is awesome!" A 

- Bill Steinberg, author of Pyro! and PBTools 

“Resorcerer proved indispensible in its own creation!" 

- Doug McKenna, author of Resorcerer 




Version 2.0 



• Very fast» HFS browser for viewing file tree of all volumes 

• Extensibility for new Re sorcerer Apprentices (CFM plug-ins) 

• New AppleScript Dictionary (^aete’) Apprentice Editor 

• MacOS 8 Appearance Manager-savvy Control Editor 
■ FowerPlant text traits and menu command support 

• Complete AIFF sound Rle disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 6SK versions 


New 

in 

2 . 0 : 


Requires System 7.0 or greater, 
1.5MB RAM, CD-ROM 


Standard price; $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 


Fully supported; it's easier, faster, and more productive than ResEdit 
Safer memory-based, not disk-file-based, design and operation 
Ail file information and common commands in one easy-to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and openg/marks/selects resources by text content 
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module, adding a new feature or tweaking an existing one. 
Also helpful is the configuration file path, which tells us 
where the phpani file lives (or should live). The Jni file is 
similar to Apache's httpd.conf and allows us to tw^eak the 
runtime settings of the module. 

• Next up is a long list of configuration directives. asp_tags. 
off by default, allows you to use <% and %> as your 
delimiters, whereas short„open_tag controls whether you 
can use the <? we've already encountered, display^errors 
.should ultimately be turned off wlien weVe ready to use PHP 
on a production system, and any errors configured w'ith 
eiTDr_reporting should be sent to an eirorjog instead 
(th(;ugh we'll use log_errors to send them to our Apache 
errorjog — confused yet’). Whetlier incoming data will 
automatically be escaped for database use is 
inagic_quotes_gpc’s intent; since it's on by default, we'll 
have to be careful to slripslasties if we use the data 
elsewhere. Finally, register_globaLs will ensure dial visitors 
or users can’t easily pollute your namespace with GET or 
POST parameters, though some programs (niost notably, the 
excellent osCommerce, http://www,oscommercexomy) require it 
to be turned off. 

With PHP certiftably enabled, let’s configure it to log errors 
into our Apache error_log. Knowing about en ors is always a very 
good thing, and by enabling all of them, w'e'll be able to w^rite 
better scripts (similar to the Perl equivalents strict and warnings; 
see last column). To do this, we’h have to modify the php.ini fde 
which lives in /usr/lib/. 

Tweaking PHP's Inttl^lization 
There’s one problem widi editing this file: it doesn’t exist, 
Since PHP is currently configured with all die standard and 
expected defaults, Apple never shipped a dummy phpJni file for 
us to modify. This isn’t cataclysmic... most of the settings we 
care about can be modified in die relevant PHP file itself, fake, 
for example, die following two scripts: 



Figure 3: Ot4r FHF scnpt, with and iiitbout error reponing. 


Out fust task, then, is to create a /usr/lib/php.ini file. 
Thankfully, we don't have to build one from saatch, as the latest 
and greatest default version is available from CVS: 
http://cvs,php.net/co.php/php-src/php.ini-dist. If you’re new to PHP or 
security-conscious {righd'ully so), it may be better to blindly trust 
the more secure version, available from http://cvs,phpnet/co.php/php- 
src/php.ini-recommended. Bodi are heavily commented and should 
be read fully to understand their nimilicadons. 

For our purposes, weTe going to use the phpJni- 
recommended file. It's aKvays be,st to start with the most secured 
installation you can, then slowly open it up when you know 
what youTe doing. The side effect of using this version is, 
iiappily enough, logging exactly how we want: none to die 
browser, eveiyuhing to the error_log. Save the php.ini- 
recommended file to your Desktop, open a Terminal, and type 
the following: 

cd Desktop 

sudo cp plip.itii-tec amended /usr/llb/php. ini 
sudo apachectl restart 


script example #1: 

<?php humiliation: 7> 

script example #2: 

<?php errcir_i:eporting(E_ALL); hmniliatloTi: ?> 

They’re combined output can be seen in Figure 3- As is 
obvirius, there's an error in the code, but only when reporting 
is enabled would we actually be informed—meanwhile our 
script wxjuld trudge on regardless, perhaps getting deeper and 
deeper into a well of cascading prolilems. Further error 
configuration is possible by using the ini_set function to set 
relevant values, but who wants to w'orry about doing that for 
every ,php file? 


Since /usryiib/ is a protected directory', you’ll need temporary 
super-user privilege.s to copy the new configuration into place. 
That's w^here sudo comes in. Likewise, .since weTe making a 
change to PHP, which is loaded as part of die Apache web 
server, we'll need to re,start Apache with apachectL which also 
assumes super-user privileges. Any time you make a change to 
httpd.conf or your new phpJni file, you'll need to restart Apache 
liefore the changes w'ill Like effect. 

You can ensure your configuration changes are enabled 
by checking the output of phpinfo, as well as running the first 
of our script examples. The browser output will remairi 
unchanged, but the error will be logged into Apache’s 
error_log—see Figure 4. 
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Figure 4: With ourneui php Mi file, errors are 
logged to Apache's error Jog. 


Homework Maugnments 

In our nt^xt colunin, well tiike a look into damhases, 
specifically the MySQL server^ and how to integrate our PHP 
scripts with them. Because it's so easy lo use PHP to hook 
into any database, you’ll often be hard-pressed to find a 
script or application that doesn’t require the existence of 
one. Also, with Panther available by the time you read this, 
well cover any relevant differences in your web serving 
capabilities. For now, students may contact the teacher at 
nnorbus@disobey.coTn. 

• I missed an opportunity lo say “slick a fork in it; it’s done'’. 

• If you’re looking to pick up a book on developing sites with 
PHP, check out PHP and MySQL Web Developmenl by 
Luke Welling and Laura Thomson. The Second Edition is 
available from Sams Publishing and covers programming in 
PHP, fiddling with your first database and SQL statements, 
and then combining the two together to create a number of 
different applications to learn practical techniques from. 


With our new php.ini file working correctly, youll want to 
keep in mind that regifiter_gIobaLs is off (and yt)u may have to 
turn it on for some applications to work properly), 
magic_quotes^pc has been disabled, so that you’ll need to 
addslashes if you plan on putting content into a database, and 
that included files and libraries can only exist in the airrent 
directory (although you can add more lookups via 
include_path, w'hich previously had include /usr/fib/php). 


• You may have noticed that the PHP shipped with OS X is 
only 4.L2, even though, at rime of writing, 4.33 H available. 
If you absolutely must be using the latest version, be sure to 
check our Marc Liyanage's downloadable package available 
from http://www.entropy.ch/software/macosx/php/. It’s full of 
features not enabled in Apple’s version (compare 
http://www,entropy.ch/software/macosx/php/tGSt.php to ours), and is 
easily removable for w'hen you want to take a step back to 
tlie defaults. 
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PATCH PANEL 


By John C. Welch 


Printer Usage Reports with AppleScript 
and CUPS 


Finding out who’s printing what in 
Mac OS X 


Print Logs 

One of the biggest is^siies For any network administrator is 
dealing warh print accounting. Now, with Mac OS X .server, you 
have the tools to deal w'ith printer accounting, and Mac OS X 
Server 10.3 should give you even more tools for nranaging 
printers, and printing. But what about folks who are just 
sharing a printer from Mac OS X? One could argue that in this 
case, you don't need to manage your printer access at the same 
level that you do m a serv'er - based network. However, for 
many small companies, or small neiw'cjrks that share printers, 
it s good to be able to know’ who is printing w hat and how 
much paper tliey are using. It's also a neat exercise for 
AppleScripters, and sometimes, just doing something in a way 
that mo.st people wouldn't think to, and having it work, is 
pretty cool in and of itself. 

Again, if you are kxjking for brilliance in AppleScript, talk 
to people like Sal Soglioian, or Bill Briggs, or Paul Berkowitz, I, 
like any other programmer or scripter, do things the way they 
make sense to me. If you can, as has happened in tlie past, 
rework my ccxie and get huge efficiency gains, etc. out of it, by 
all means do so, and send it back to me. I can use tlie help! I 
al.so realize that tliere are a half dozen shell utilities that 1 could 
use to make this a LOT faster, and simpler. But tfien, I wanted 
to do tliis entirely in AppleScript, and so, liave to live w'itli its 
ratlier anemic text processing abilities. (Yes, yes, Perl folks can 
fee! rightly smug. But I can script Photoshop, so nyah!) 

So die object of this script is to prfKcss the printer logs that 
are created by CUPS when you print in Mac OS X, imd output a 
number of things as a tab-delimited text file, giving you the 
option to then open it in Microsoft Excel or Filemaker Prcj, or just 
leave it where it is. The text file lists the total number of printers, 
total number of users printing to those printers, total numlxir of 


pages printed through that maclune, total number of pages per 
printer, and total number of pages per user. Since tills script uses 
CUPS, it obviously recjuires at least Mac OS X 10.2 or later. 

The CUPS log 

Since w^eTe talking alx)ut the CUPS log, we should take a 
quick look at it. Every time you print in Mac OS X, the CUPS 
printing system records the printer name, die u.ser name, the 
page count for each page in a job, the date/iime stamp for each 
page, the page number, the total numlier of pages, optional 
billing information, and the name of the host that sent the job to 
the host acting as a server to the printer. The [>rinier in this case 
doesn’t have to be a physical printer. If you have Adobe Distiller 
6 installer!, it also logs jobs sent to the "'Adobe PDF" printer, even 
though it only creates PDF files. 

In a Mac OS X system, die log file we are using is the 
pagejog file, stored in /var/iog/cups/. While you canT easily 
modify that file without using sudo^ or su, anyone can read the 
file, so this script can lie run by any valid user on an OS X 
system. A sample of the log file from my machine is .shown 
below. 


Prirttrr naiia' user 

pb id 

I>a(c/l"tmc stanip pge/copy acct.hosi 

H P_Ij 1 S0_Serics2 

Ki 

|m/Oct/2003:in:M:SB -OSOO) 

] 1 

- bcaUiosi 

HJ*^Lm'rjLn BlSti Sene?i2 |weldi 

16 

[D8/Oct/2003:10^35=00 -05001 

2 1 

- bcalbosl 

BlTljuserJe[BISCl iiefie!!i2 jwddi 

16 

[Oft 0X^3:10:55:01 -05001 

31 

- kxaihcKil 

HF LiserJd 8I S0^5t'ric;s2 jvvdch 

16 

[[)ft'0a^2003:l0:55ra2 ^15001 

A 1 

- [ocalhfist 

H iwekli 

16 

[0ft'0ct/2003:l0r55:0‘l ^15001 

5 1 

- Ifncaihosl 

HlTLasttAH..81 SO.StTiesl jwokli 

16 

l(m>.V2003:10:55!Of> 4)5001 

6 1 

- localhosS 


lliis is from a 6 page job, printed to an HP LaserJet 8150, by 
me. The printer is on an AppleTalk connection to my machine. 
So going field by field, w'e see the printer name is 
‘*HP„LaserJet_8150_Series2, the user sending the print job is 
"jw'clch'’, the job id is "16”, the Date/Time stamp tells us this job 
was printed on October 8, 2003, around 10 am, there were 6 


John Welch <jwekh@pravar.conn> is a Technical Strategist for Provar, (http://www.prQvaf,com/) and the Chief Know-It-All for TackyShin, 
(http://www.tackYshirt,com/), He has over fifteen year's of experience at making Macs, and other ajmputers work, John specializes in figuring out ways 
to make die Mac do what nobody thinks it can, show^ing diat the Mac is a superior administrative platform, and teaching others how to use it in 
interesting, if sometimes frightening ways. He aLso does things that don’t involve computertry on occasion, or at least that's the rumor. 
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See Dick. See Dick run his business 
with software that wasn’t written 
and designed for his Macintosh. 

Poor Dick. 




A moment of silence for Dick, please* A good 
guy with a good small business, bur his accouniing 
software was one of those PC rranscripciou jobs, 
not pure MAC like MYOB AccountEdge and 
MYOB FirstEdge. 

If only he’d known abour the amazing capacity of MYOB 
software to bring out the best in his MAC operating system. 


He could have tracked and managed finances at a glance or generated all the 


reports, invoices, and tax documents that he and his accountant would 
ever need- He could have spent more time with his clients. 
If he had only known that MYOB develops the world s 
best selling MAC small business management 
software for lots of good reasons, this storj' 
might have had a happy ending. Sorry Dick. 

MYOB, 

THE MAC ANSWER, 



«!2tiE>3 MYOB us, tnc. wwwr. myob.com/us 



































Images for one copy, (note that if' the printer doesn’t have a 
^mopy" function, or multiple copies per job, Uiis is always 1), the 
accounting field Is a since by default, Mac OvS X doesn’t 
include this information, and since this job was sent to my 
computer by my computer, the host name is “localhost’'. In the 
pagejog file, tlie fields are space delimited, but I used tabs here 
to break the fields up better. As well, there is one entiy"^ per page 
printed. Botli of the last two bits of information will be important 
to us as we proces-s this file in the script. 

Script Properties 

property the Prints rNameList : [ J -a list of primer names, ansorted, one per 
line in ihe thePageLogContentsList 

property th eP r i nt e rTyp eLi st ■ I) -a I ist of unique printer names, I line per 
printer name, derived from the gctThingiypes handier 

property wasThereAMatch ^ 0 -used in the getThinglypcs handler as a match flag 
property theUs e rNameLi st : i I - a 1st of user names, unsorted, one per line in 
the thePagcLogConicntsList 

property theListedUsers : H -a list of unique user names, 1 line per user 
name, derived from the gelThingTypes handler 

property totalPagesForMachine : 0 -holds lie total pages printed by the 
machine 

pit>perty pagesBvCserList: 1) -a list with one entry per user page total. THIS ONLY HAS 
THE number/ 

-YOU KAVETO .MATCH WITH UieLisiedUsers TO GEl' PAGESAISER! 
property pagesByPrinterUsi: (] -a list with one entry per printer page total .THIS 
ONLY HAS THE NUMBER, 

-YOU HAVE TO MATf:H ri’WlTH thePriini.rT>T^elistTO CiET PAfiES/priittcr! 
property theTotalCountedThings : 0 -used as a counter in the gctThcLisi 
handler 

property tbETotalComtedThingsList : II - generic handler processed list 
variable for pajising lists back and forth 

property theListedTbing i U -generic list variable for passing data to 
handlers 

property theCatreTitThing : -generic text variable for various handlers, 

used mostly for matching ops 

property theCurrentThingPages : "" -used as a variable in 
ge0ataByPrintcrOrUscr for holding page counts by user or printer 
property theCurrentLlne : ”” -when processing tliePageLogContentsList, 
holds one line of that list as a string 

property theCorrentLineCoGtentsList ; If -when processing 
thePageLogContentsList, holds one line nf that list as a list 

property^ usernameOrPrinEerName : H -handler variable, tells if you are dealing with a 
printer name or a user name, is a 
-list placeholder, 2 = user, 1 = printer 

property userOrPrinter : -text flag used in gctDaiaByPtinicrOrUser for 

determining user or printer in repon line 

property theLastThing : 1] - generic handler unprocessed list variable for 
passing lists hack and forth 

property theLlstedThingType : ” ” — used as an inner repeat Imp malching 
variable holder in the geiTliingTypes handler 

property theLiatedThingPages e 11 - generic handler list variable for 
processing pages ByPri nterList and the pages ByllserUst 
propsety theErinterReportFllePath : — alias to where tlie tab 

delimited ftle will be, set by user 

property thePageLogAlias ; ” ” —alias to the cups page log file 
property thePageLogPath i —POSIX path to the cups page log file 
property tbePageLogFile : 0 -file handle when rending the cups page log file 
property thePa geLagContents : ”" -holds Ihe contents of the Cups page log 

hlc 

property thePageLogContentsList : (1 -holds the Jisi version of 
thePageLogContents 

property tb e W r 1 1 e : "" -pi aceholder used to generate the repent fi le 

The comments following each ™ are the ones I used wliile 
developing the script. 1 have learned over the years that a certain 
reflexive obsession with regard to commenting comes in handy 
when revisiting code for things like updates, or writing articles 
on it. Because AppleScript’s native text liandiing capabilities are 
anemic at best, we use a lot of lists to compensate. While there 


are a number of AppleScript extensions, or OSAX that make up 
for this, I try to avoid them where possible, so my scripts will 
run on the largest number of macliines possible without 
requiring the user to download and install extensions. If the 
property names and comments don't make sense at the moment, 
don't worry. As we go through the rest of the code, you’ll see 
what they’re all used for. 

The Main Script Body 

The first thing we see is a call to System Events, a part of 
Mac OS X used for certain system functions that w^ere handled 
by the Finder in Mac OS X. While we could use the Finder for 
this, System Events is the more correct way to handle our needs 
here. In this case, we ask System events for die name of every 
disk lal^eled a startup disk, and get the name of the first one. 
Since diere should only be one of these, assuming the first one 
is the one we want poses linle risk of error. Since a list is 
returned, we have to grali the first item from die list, even if it 
is the only item: 

tell application *^5701611 Events" -get the name of the startup dis^k code 
set theStartupDiskList to (the nanie of every disk whose 
startup is true) -gets a ILsl ail startup disks 

set theStartupMskNarae to item 1 of theStartupDiskList -on 
any running Mac,ihea' is only one startup dL4%Ki it's alivays item 1 
end tell 

The next set of line.s gel an alias to the page_log file, and 
the POSfX, or Unix - style path version of that alias. The first line 
also concatenates the name of the startup disk that we got earlier 
HO that we have a full alias to the pagejog file. The conversion 
to the POSrX path handles renaming the disk name in the alias 
to a more proper 

set thePageLogAllas to (theStartvpDiskHanie h 
i private: var : log rcups: page_log") as alias -get the path to the page 
l(^ file. Hardcoded unless U needs uj move alwui 

set thePageLogPath to POSIX path of thePageLagAlias -posixpath 
of thePageLogAEas, just in case 

The next lines open the pagejog file writheut write 
pennission. It would lx hard to open it with write permission 
unless root wxs nmiiing the .script, and this way, w^e avoid 
accidents. We then dump the contents of the file to the variable 
“thePageLogConients”. We then close the file access handler so 
that we don’t have open file handlers laying alx)ut: 

set thePageLogFile to opc.n for access thePageLagAlias without 
write permission -open Hie page log lUt readonly it's all we need, and it's safer 
set thePageLogContents to read thePageLogFile -dump the comeni^ 
of the file into a variahle 

close access thePageLogFlle -close llic file handler, leav^ing those open is bad 

Now, SO that we can more easily use the contents we’ve just 
read, we mm it into a list, writh each line in the log being one 
item in the list. To do diis, we use the end of line chameters as 
text item delimiters, by telling AppleScript to use the “Vh'" 
character as its new text item deliniiier, saving the original value 
to the variable “oldDelims” so we can restore it later, llien we 
make a list IVom every text item in thePagelogContents, one 
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item per line. Once that’s done, we clean up after ourselves by 
resetting AppleScript’s text item delimiters to their original value- 

set oldDelims to. AppleScript' s text item delimiters -temp store 
AppJescripi airrent delimiiers 

set AppleScript^s text Item delimiters to "" -use\nas the current 
delimiter, sincr it's a Unix text file 

set thePageLogContentsList to (every text item of 
the'PageLogContents] --turn the page log into a list 
set AppleScript's text item delini.ite.rs to oldDeliras -resetthe 
delimiters 

We then take advantage of CUPS creating one line per page 
printed, and use the length of the list to get us that infonmtion, 
and store it in totalPagesForMachine. Since the last line of the 
log is blank, we subtract one from the length to get the correct 
number of pages: 

set totalPagesForMachine to ((length of 
thePageLogGontentsLlst) ■ 1) -the Iasi line is always hl^ 

ITie next bit of code takes advantage of the consistency of 
the pagejog fonnat. Since it always has the same number of 
fields and each field always has tlie same contents, we can make 
some assumptions that let us get the printer name and user 
name. In tills case, the first field is always the name of die 
printer, and tlie second field is always the user name. So, w^hat 
we do is make two lists, one of user names and one of printer 
names by manipulating the AppleScript text item delimiters for 
each entry in thePageLogConientsLLst, which is, as we should 
still recall, one line from the original page_log file. By using the 
space character for die delimiter, we temporarily turn each entry^ 
in thePageLogContentsLisl to a list of its own, then grab item one 
and shove it into a list of printer names, then .shove item two 
into a list of user names. Yes, we’ll have duplicates, but we’ll 
handle those in a bit. Once we’ve done thi.s for the entire 
ihePageLogContentsList, we’re pretty much done with the main 
bexiy of ccxle for the script for the moment, as the next few 
sections are mostly calls to handlers: 

repeat with x from L to (length of thePageLogContentsList) - 
thb is to gel us two lists.. . user names and printers 

set theCurrentLiae to item x of thePageLogContentsList -grab 
a tine out of the list 

set oldDelims to AppleScript's text itenj delimiters -temp 
store AppleScript current delimiters 

set AppleScript's text item delimiters to " " -‘Usc space as the 
current delimiter 

set theCurrentLineContentsList to {every text item of 
theCurrentLlne) -turn the page log line Inio a Hsi 

if item 1 of theCurrentLineGontentsLlst is not then - 
check for that blank hne 

set the end of thePrinterNaiiieList to item 1 of 
theCurrentLineContentEList -item 1 is always the primer 

set the end of theUserNaiiieList to item 2 of 
theCurrentLineConte tits List -item 2 is always the Ute username 
end if 

set AppleScript’s text item delimiters to oldDelims -resetthe 
delimiters 
end repeat 

So, now we have a list of users and a list of printers, but at 
the moment, they aren’t that useful Since each job has one entry 
per page, we are going to have a lot of repeats, so w'e need to 
make sure w^e only have one of each user or printer. First, lets 


take care of the printers. While we could use unique handlers 
for each of these, we don’t have to. The code to handle the 
printers and the names is almost identical, so with a little work, 
we can use one handler to process both. One thing I did here, 
which you may or may not agree with proceduralJy, Ls to use 
generic names for the handlers. If nothing else, it makes it 
harder for me to forget that Fm out of the main body of ccxle, 
and in a handler. 

Calling our Ixindler, and getting a return back takes three lines. 
Hie first sets our handler variable to the contenLs of 
thePrinterNameList. The second sets the variable thePrinterTypeList 
to the results of getlhingTyeps(theLisledThing). Once the handler 
ts finished, then we clear tlieTotalCxxintedThingsList. (used in the 
hancUer): 

set theListedThlDg to thePrinterNameList -I prefer using generic vars 
for miiliipurpusc liaudleni, it 's easer for me 

set thePrinterTypeList to getThingTypes(tbeListedThing) of me 
-get a list of unique printers 

set theTotalCountedThingsList to [) -clear this Jisi 

The getThmgTypes{thellstcdThing) Handler 

Now, let’s take a look at the getThingTypes(theListedThing) 
handler. The handler uses a repeat loop to iterate through the 
list, theListedThing, We check to see if theLastXhing is blank, 
which indicates that this is the first time through the list. If it is, 
we set thelastThing to the first item in theListedThing. This is 
important, since this handler’s purpose is to create a list of 
unique user or printer names. We also set the current item of 
theListedThing to the end of theTotaiCountedThingsList, since 
this is the first time through the list: 

repeat with y from 1 to (length of theListedThing) -run the list 
of (tames 

if theLa St Thing is "" then -if this is the first iteration 
set theLastThing to item y of theListedThing -set 
theUist'niijig as a comparator 

set the end of theTotalCountcdThingsList to item y of 
theListedThlrig - first name in the list is tlie first name on the new list 

end If 

Next, we set theCurrentThing to the CLirrent item of 
theListedThing. This is going to be the prime variable used to 
check for duplicates: 

set theCurrentThing to Item y of theListedThing -test against the 
ciirrenL item 

We now compare theCurrentThing to tlieLasfThing. If they 
aren’t equal, good. But since we have to check for more than 
one duplicate, we can’t stop there. This is where 
theTotalCountedlliingsList comes into play. We run another 
repeal loop through that list, assigning thelistedTliing type to 
the current item of the list as we run tlirough this loop, and 
compare it to theCurrentThing. If there is a match, we set 
wasThereAMatch to 1, and exit the loop, If we make it through 
theTotalCountedThingsList without a match, we set 
wasThereAMatch to 0. Once we are out of the loop, if 
wasThereAMatch is 0, then there w'as no match, and 
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iheCurrentThing is a unique name, so we lack it onto the end of 
theTotalCouniedThingsList. We then set wasTliereAMatch to 0, to 
clear the loop. This is done fur every entr)' in theiisted tiling. 
Once we have checked every entry^ in dmt list, we clear 
wasThereAMalch and iheLastThing. We pass 
theTotalCountedThingsList^ wliich Ls now a list of unique 
printers or usernames back to the calling code line, and tliat’s 
the end of the handler 

if theCurrentThing ^ theLaetThlng then -no, noi the same thing 
repeat with z from 1 to (length of the 
theTotalGoyntedThingsList) -mn the list of printer types we alrtady have 
set theListedThliigType to item z of 
theTotalCountedThingsList -grab s name to test against 

if tbeCtirrentThing " theiistedThingType then -is this 
printer already in here? 

set wasThereAMatch to 1 -yes 
end if 

end repeat 

if vaeThereAHatcb = 0 then -new printer ty^pe 

set the end of theTotalConntedThingsLlst to 
theGurrentThing -sUek this in iht list of printer types 
end if 

set wasThereAMatch to 0-clear the \'ar in the hx)p 
end if 

end repeat 

set wasThereAMatch to 0 -clear Qie var 

set theLsfitThing to -clear the var 

return thelotalCounted Things List -here’s u list of unique names 

Qur next three lines hack in the main body of code call 
gctThingTypcsC thcListedThing) to gel a list of unique user names 
in ilieUstedUsers, and works the same as w'liat we just saw for 
gelling printer names. We, thereibre, have the same handler 
used to gel Iwo different lists of data, without duplicating the 
ctxle. Code reuse is real, and tl rocks. 

So, we now have a list of users and a list of printers, and 
the total pages printed. Not bad, but we need to know how 
many pages each user printed, and how' many pages each 
printer printed. Again, we're going to use the same handler to 
get tills information, but we also need to track what we're trying 
to get, printer or user info, stj we use the variable 
usernanieOrPrinterNaine to do this. Rememl>er that in the 
page^log hie, the printer name is always the first field for each 
entiy^ and the user name is alwiiys the second field, tf we are 
looking for user data, wx" set usernanieOrPrintcTName to 2, and 
if w^e want printer data, we set usernameOrPrinterName to 1. 

We again use theListedThing as the list variable we pass, 
and since we are kxiking for u.ser data, we set it to the contents 
of thelistedUsers, We set u.sernameOrPrinterName to 2, 
indicating we want u.ser data, and then pass both of them, along 
with ihePageLogConrenisList to getTheList, and return the results 
to pagesByUserList. Once we are done with the handler, we 
again clear thelbtalCountedThingsList: 

set theListedThing to theListedUsers 
set usetuaiiieOrPrinteirNaiiie to 2 -we're going to get user pages 
set pagesByUserList to getTheList(theListedThing, 
thePagsLogContentsList, usernameOrPrinterMame} of me 


set theTotalCoimtedThingsList to II 

The getTheUst(theUstedThiiig,theFageLogC^ 
usernameOrPrinterName) Handler 

Now', lets look at the 

getTheListCtheListedThing^thePageLogContenisList, 
usemameOrPrifiterName) handler. We use a repeat loop to itemte 
through theListedThing, which, in this case is the list of unique 
user names. We .set theCurrentThing to the current item in tliat list. 
We tlien set another repeat loop for thePageLogContenlslist, We 
set tiieCurreniLine to the current item of that list. Next, w'e call on 
our old friend, AppleScript’s text item delimiters to turn 
tlieCuirentLine's contents into a list, theCurrentLineCx)atenLsLLst. 
Since CUPS loves to insert blanks, we make sure that item 1 isnf 
blank. Now, die next part is a little tricky to follow^ We have set 
theCurrentTliing to the ctirrent item of theListedThing, which is for 
now, a list of user names. We had also set usernameOrPrinterName 
to 2, indicating we looking at pages per u.sec So, we need to 
only count the pages for a particular user. So, we check to see if 
item usernameOrPrinterName, or 2, of tlieCurrentLineContentsUst 
matches theCurrenilliing. If it dc^es, then we want to count tliis 
line as a page printed by that user, (pageJog uses one line per 
page printed), and increment our page count, 
theTotalCountedThings. Once we have gone through 
lliePageLogContenLsList, we reset Aj>pleSc’ript's text item delimiters 
to their default. Next we set the end of theTotalCountedThingsList 
to theTotalCountedThings, and .set ilieTotalCountedThings back to 
zero, so we can get the page count f<jr die next user name in 
theListedThing list. Once w'e have completely run through that list, 
we then rehirn iheToialCountedThingsLLSi to tlie cTilling line, and 
exit the handler: 

on getTheList (theListedThinB- tbeFaBeLogContentsLlEt* 
us e rn aiaeOi-P r in t e rNaine) 

repeat with x from 1 to (length of theListedTliitig) -let'sget 
the tt JtaJ pigeii by iwer Unit 

set tLeCurrentThing to item x of theListedThing -set the 
current user we aie l(Hiking 4l 

repeat with y from 1 to (length of 
thePageLogCoatentsList) -now we w;im ta pel total imr pages by user 

set theCurrentLine to Item y of thePageLogContentsList 
-grab A line 

set oldDelms to AppleScript's text item delimiters - 
temp stiirc Appleseripi eumrnt ddlmiters 

set AppleScript's text item delimiters to " " -usespace 
as the current delimiter 

set theCurcentLlneContentsLlst to (every text item of 
theCurrentLine) -m:ike the line a list 

if item 1 of cheCurrentLineContentsList is not then 
-there's alwa>s a blank line Mow things up 

if item usernameOrPrinterName of 
theCurrentLineContentsList = theCurrentThing then -iftlieiiser 
we're looking at printed this 

set tbeTotalCountedThinigs to theTotalCountedThings 
+ 1 -increment the page count for the user 
end if 
end if 

set AppleScript Vs text item delimiters to oldDelims - 
reset the delimiters — 

end repeat 


set the end of theTotalCountedThingsList to 
theTotalCountedThings -build the list 

set theTotalCountedThings to 0 -cleartherar 



Printek Usagk Rei^ok’i^ will Aiqn^ScRiFr and CUPS 


MacTech • November 2003 • 






Aladdin 


Generate new software 
revenue streams— 
securely, effectively. 


Selling, distributing and activating software 
electronically isn't new. But doing it securely 
AND all from one source certainly is news! 
With Privilege from Aladdin, you can have: 


Via the Internet: 

■ A secure ESD process^ transforming casual 
sharing into a super distribution channel 
for trial ware 


■ Increased customer satisfaction and loyalty 
with short and simple purchasing process 
and resumable downloads 


■ Instant access to international markets with 
multi-language support 


Via digitai media and CD: 

■ Your choice of CD\ or pre-loaded trialware on 
new computers^ with flexible software activation, 
try-before-you-buy and try-only 

m Capture new opportunities with full control over 
licensing terms^ offers and the user's experience 


Take advantage of every new revenue 
opportmiity available today! Call us at 
1-800-562-2543, or visit GoPriviiege.com to 
receive a FREE Privilege information pack. 


<5JOOl Aladdin Knowl^ge Ltd. Privilege taa uademafk of Aladdin Knowiedgg Systems, Ltd. 



















end repeat 

return theTotalCountedThingsList 
end getTheList 

Back in the main body of the code, we call this handler 
again, only to get the printer pages. The code works exactly the 
same, as in fact, it's the same handler. The only difference is 
which field in the page_log file we're dealing with. 

Now that weVe collected a bunch of data, we need to 
create the ouput file for it. First, we ask the person running the 
script where they want to save the file, and what they want to 
call it. Tliis is done with choose hie name, which gives us an 
alias to a file that doesn't exist yet. 

set thePrinterReportE'lleFath to choose file name with prompt 

“I 

'^Pick the location for the printer report file" default 
name ‘^Printer Report File. txt" -user mteraction, pick where you w;mt 
the (uitput file to go, and give it a name 

Then we set the variable theWrite to a nice long text string 
with the data we already have, such as total number of printers, 
total number of users, and total pages printed from this machine. 
Each line is tab-delimited with the “\t” character, which doesn’t 
show up on screen once the script is saved, and each line is 
created with the ‘‘\r” character, which is invisible once the script 
is saved, and interpretetl as a return: 

set theWrite to ["Total number of Printers " ^ (length of 
thePrinterTypeList) & " 

Total number of Users " & (length of theListedUsers) i "■ 

Total number of pages for all printers " & 

total PagesForHachlne) as text the non^iscr ncm-jipecific thingji, dump 

it into a lexi string var 

But we Still want a few^ more things, like pages per printer, 
etc. in tlie report. So, we set theListedThing to thePrinterTypelist, 
and LheListedThingPages to pagesByPrinterList. We use the 
usernameOrPrinterName variable again, setting it to 0, to show 
the next handler that we are getting page.s per printer We then 
set theReport to the result of the handler 
getDataB yP rinterO rUserf cheL isiedTh i ng, I h e Li stedTh i ng Pages, 
theWrite, usemameOrPrinte rName): 

set theListedThing to thePrinterTypeList 

set theListedThingPages to pagesByPrinterList 

set usernameOrPrinte rName to 0 -wo rn going to get how manj pages cadi 

printer printed, and dump it into a text string 

set theReport to getDataByPrinterOrllser(theListedThing, 
thsListedThingPagesp theWrite, usernameOrPrinterMaine) of me - 
get pagps by printer, atid gloni it on the end of theltcpori 

The getDataByPrinterOrllseKtheListedlliing, 
thelistedTliingPages, theWrite, usenianieOrPrinterName) 
Handier 

The handier we use here is fairly simple. First, we check to 
see if we are doing printers or reports: 

if usernameOrFrinterKame = 0 then -which one are we leaking at 
sat us&cOrPrlntet to "Printer" 
else 

set userOePrinter to "User" 
end if 


Next, we run a repeat loop to iterate tlirough 
dieUstedThing. We set iheCurrentThing to the current user or 
printer name in theListedThing, We then set 
theCurrentThingPages to the same item in a different list, 
ihelisiedThingPages. {The only reason this works is that thanks 
to die way CUPS sets up its pagejog file, and the way we have 
gotten the data from that file, die lists synchronize nicely, I know 
this is a rather fragile way of doing things, but for now it works, 
and saved me a lot of work when 1 wrote this script> Obviously, 
anytime CUPS or Mac OS X get updated, the script should be 
tested to see when this finally breaks,) Then we concatenate a 
new line onto the end of theWrite, which gives us a tab- 
delimited line that shows Trinter” <tab> theCurrentThing 
<tab>"total pages"<tab> theCurrentThingPages. By placing the 
return character in Front of the word “Printer” we ensure that 
each time we run through this list, we are creating a new line. 
Once we’ve run through theListedThing, the repeat loop exits. 
We clear out theListedTliing and iheListedThingPages, return 
tlieWrite, and that’s the end of the handler; 

repeat with x from 1 to (length of theListedThing] -rim through 
ihti iLst of printers or userji 

set theCurrentThing to item x of theListedThing -grab Che 
first printer or username 

set theCurrentThingPages to item x of 
theListedThingPages -grab tJie first page tount by user or printer 

(This is to work around si>me annoyanees with records thai make it easier to 
use two lists, As it turus out, positionally, everything lines up. I imagine this will bite 
me one day) 

set theWrite to theWrite & " 

" St usefOrPrinter & " " 5c theCurrentThing & ' total pages " & theCurrentThingPages - 
ap(>end pages for a printer or a user in 

-tab ■ delttuited format 
end repeat 

set theListedThing to 11 -tlear the var 
set theListedThingPages to I I -clear the var 
return theWrite -return the new text data 
end getDataByPrinterOrUser 

Now, we reuse the handler to get pages per user into our 
report in the correct fomiat: 

set theListedThing to theListedUsers 

set theLlstedThlngPages to pagesByUserList 

set theWrite to theReport -theWrite diJesn't update completely when you 

jack it between handlers, so diis fixes that 

set username0rPrInterName to 1 -we re going to get how many pages each 
user printed, and dump it into a text string 

set theReport to getUatsByPrlnterOrUser(theListedThing, 
theListedThingPages, theWrite. uBernameOrPrinterName] of me - 
get pages by user, and ^om it on the end of theReport 

Okay, we’ve got our report. Let’s write it out to a text file! 
First, we set thePrinrerReporrFile to the rile handle returned by 
the open for access function. Since we are writing to the file, we 
obviously want to open tlie file, (using thePrinterReportFilePath 
we got from the user earlier) with write access. We then write 
the data in theReport to thePrinterReportFile, and then close the 
file handle. Almost done! 

We could just end the script there, but face it, what do you 
do with a tab-delimited text file? Well, you mostly use it in other 
applications, such as FileMaker Pro, or Microsoft Excel. So let’s 
save the user some time, and deal with tliis now. 
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First we set up a nice diahig box that tells the user the 
report has been created and W'here. We also allow them the 
option of inserting this report intcs FileMaker Pro or Microsoft 
Excel. We also, of course, allow them to do nothing, end the 
script and get on witli other tilings. We set theProcessingRecord 
to the record returned from display dialog: 

set theProcessinaRecord to display dialog ’’The Printer Report 
has been created at: 

& (ihePrlnterReportFllePath as text) tt " 

Please click the button that corresponds to the application 
you vould like this file opened in" buttons l"Hicrosoft 
Excel". "Filettiaker Pro", "Hone"') default button "Norie" with 
icon note -nice option if you want to process this file right away 

Inserting into Microsoft Excel or FileMaker Pro 

When you are dealing with scripiing any of the Microsoft 
Office applications, other than Entourage, you have to deal with 
a rather cxld dictionaty^ setup, prirruirily because things like Excel 
can be scripted in either AppleScript or Visual Basic for 
Applications (VliA). To make things easier, Microsoft had to 
make some unique decisions in the dictionaries for Excel and 
Word, so they do Icjok a little odd. ExclTs dictionary is quite 
useful, you ju.st have It) wrap your head around it. 

The biggest oddity that affects the script is that Excel really 
can't handle aliases, so we have to convert the alias to a text 
string, then tell Excel to open it: 

if button returned of theFrocessiugRecord * "Mifirosoft Excel" 
then -dvunp it into Excel 


try 

tell application "Microsoft Excel" 

open CthePrintarRepartFilePath as text) -Open can’llwndk 
abases, so we have to use a text version 
end tell 
end try 

FileMaker Pro is a bit sijiipler. since It can handle aliases: 
else if button returned of theProcesalngRecord = "Fllemaker 
Pro" then ndump the fik into FMPm 
try 

tell application "FileMaker Pro" 
open theP rinterReport FIlePath 
end tell 
end try 
end if 

If they don’t pick either Excel or FileMaker Pro, tlien we 
leave the file alone, and the script is done. 

Conclusion 

Well, thafs a lot of list work, but you get a neat, and 
possibly useful result. Printers can be a huge expense if their use 
isn't monitored clasely. Thanks to CLIPS, Mac OS X and 
AppleScript give you a way to dc^ this. Now, there are still some 
tilings we could do with the script, such as tiy^ing to get pages 
per printer per user, etc., but this is a good start. As well, some 
judicious shell commands could make this script much shorter, 
and probably faster, ilfs not that long now, though, and my tests 
didn’t show^ that it took all that long to run on an HOOMHx 
PowerBook G4, so it’s probably okay as it is. If nothing else, 
consider this an example of how AppleScript is still quite useful 
to the network administrator in Mac OS X* 
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By Rich Morin 


File System Security 


How (not) to make OS X as secure 
as MS Windows... 

Mac OS X inherits most of its notions of file system security 
from BSD. Each file system node (file, directory, has sets of 
permission Ci.e., mode) bits for its owner, its group, and 
everyone else. The node’s owner is restriaed by the first set of 
mode bits. Other meml^ers of the node's group are restricted by 
the next set. Everyone else is restricted by the final set. 

Let’s l(x>k at some of the top-level permissions on a Mac OS 
X (10.2.8) system, to see how this plays out in practice: 

Is -dl /bin /sbin 

drwxrxrx 35 root wheel /bin 

drwxt-xr-x 60 toot wheel /shin 

1’he first set of mode bits (rwx) allows these directories’ 
owner (root) full access pennissions. S/he can read (e.g,, look up 
entries), write (e.g., add or remove entries), and execute (e.g., 
access entries) in the directory. 

The following sets (r*x. r^x) restrict other users from writing, 
but allow read and execute access. Note, by the way, dial diis 
does not prevent someone from writing into an existing hie in 
one of these directories, if the [permissions of the file allow' this. 

In summary, nobody but root is able to write (e.g., create 
files.) in any of tliese directories. So, 'formal’’ users (and the 
programs they may accidentally or unsuspectingly) aren’t able to 
add, remove, or rename programs. 

This is very^ much what we’d expect in a well-designed. 
BSD-based system. Allow'ing user errors, programming mistakes, 
or malware to modify the system's executable code is (as myriad 
Microsoft-specific viruses demonslTate) a serious design error. 

Unfortunately, Apple doesn’t follow' BSD's example 
eveiy'where; .some Mac OS X system directories are all tcxj 
vulnerable to the aforementioned tlireats: 

% Is -dl /App*s /Developer /Library 
drwxrwxr-x 59 root admin ... /Applications 
drwxrwxr-x 14 root admin ... /Developer 
drwxrwxr-x 40 root admin ... /Library 


In an effort to suppcprt "ease of use”, Apple’s engineers have made 
some critical directories far more tjpen than tliey would be on a 
conventional Unix system. As a result, mtist users (and any programs 
tliey may run) can add, delete, or replace any ntxle in these directories. 

In a fine example of the "Law of Unintended 
Consequences”, several plausible decisions work togetlier to 
produce this undesirable result. Here’s how^ it goes: 

• The first acccmnt created on a new system has “admin” 
privileges, by default, and few^ users bother to set up a separate 
administmtive account. So, most users have admin privileges, 

• Any user who has admin privileges is put into the admin group, 

• The admin group has write pennission for all three of these 
directories, so any member of the group can add, delete, or 
replace any node in these directories. 

• Any program run by a user has, by default, the same 
pennissions as the user. 

Here’s a simple (and safe :-) experiment you can try. Note 
that the system prevents you from modifying /bin, but allows you 
rt> modify /Applications: 

% groups 
admin 

% touch /Applications /biti 
touch: /bln: Permission denied 

In most cases, die system asks the user for authorization 
belbre taking any unusual or suspect action. Consider the 
passw'ord dial sudo(8) requires and the authorization dialogs that 
come up on occasion (e.g.. when installing software). 

In this case, however, no warning is given. Any user w^ith 
admin privileges is quite free to drag folders in and out of 
/Applications: no authorization dialog will come up. Apple is quite 
aware of this situadon; in fact, their documentation suggests a 
pos.slhle worka ro u nd: 

Only admins can install software in the Applications 
folder You may find that you want to set up a user 
account that dcx?sn’i have admin privileges and use that 
for day-to-day tasks. That w^ay you won’t absent-mindedly 
delete an applicadon by accident. 


Rich Morin has been using computers since 1970, Unix since 1983, and .Mac-based Unix since 1986 (when he helped Apple create A/UX 1.0), When 
he Isn’t writing this column, Rich ruas Prime Time ITeeware (www.ptf.COfn), a publLsher r)f books and CD-ROMs for tlie Free and Open Source software 
community. Feel free to write to Rich at rd[Tl@ptfconi. 
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“ http://www.apple.com/macosx/learning 


r strongly suspect, howevei; that most machine owners will 
never see this advice. Even if they do, they may decide to ignore 
it. Ix>gging in and out of accounts is a time-consuming hassle, 
Pantheds ‘fast user switching'' will improve this situation, but it 
will still break the user’s concentration. 

So, most users will run as admin, expecting the Finder (and 
other apps) to ask them before doing anything odd. 
Unfortunately, the Finder won't even be called into play if a 
rogue application is bent on rewriting parts of the file system 
(e.g., installing vims code). 

In summary, Apple has opened up a major security hole 
that is not present in Mac OS X's forebears (Unix, FreeBSD, 
Expecting application programmers (or worse, users!) to 
compensate for insecure directory permissions is simply bad 
design. The underlying system needs to be secure; exceptions 
can then be made on a carefully-controlled basis. 

In tliis case, this means that the permissions need to be 
lixed. Administrative actions can then be performed using 
“privilege elevation”, under the control of authorization dialogs, 
etc. Administrative users are quite used to being asked for this 
son of authorization, so ease of use isn't teing compromised. 
Note: Because the roi^t directory allows write permission to 
members of the admin group, you might think that it opens up 
a similar security hole. However, its pennissions (drwxrwxr-t) 
include the use of the ‘'sticky" bit (as indicated by a ‘T in die last 
position), Tliis allows admin users add items to the root 
directory, but prevents them from removing or renaming 
anything that tliey don’t own. See sticky(8) for more details. 


Third-party Apps 

Third-party developers have some excuse for being 
unfamiliar with permissions issues (classic Mac OS wasn’t real 
big on security hut by now, they should have learned the 
basics. So, it's disiurhing to find many vendors leaving their 
application packages wide-tipen to writing by any user (or 
program) on the system,, Try: 


% cd /Applications 


% is -Id 

drw^ctwxrwx 

drwxrwxtwx 

drwxrwscrwx 

drwxrwxrwx 

drwxrwxrwx 

drwxrwxrwx 

drwxrvxrwx 

drvfxrvxrwx 

drwxrwxrwx 

drwxrwxrwx 

drwxrwxrwx 

drwxrmirwx 

drwxrvxrwx 

drwxrvxrwx 

drwxrvxrwx 

-rvxrvxrwx 


grep rwxrwxrvx 

Alarm Clock S,E,.app 
AutoSync.app 
Classic Toggler folder 
Cocoa Erowser.app 
GraphicCoTivorter US 
Multiple Launcher X.app 
OmniDictiorjary. app 
OinnlGraffle .app 
PTHPasteboard 
RBrowser.app 
3huX.app 

SliMP3 Server.app 
Text Wielder 
Tri-BACKUP Folder 
VLC.app 
iCab 


Let’s say that Susie downloads a nifty-looking program and 
run.s it (e.g., from her Downloads directory^). Gee, it didn't do 
anything. That's no fun; let's try something else... Meanwhile, the 


"nifty-looking program” has infected any vulnerable third-party 
apps. When Susie's mom runs one of these (using an admin 
account), the infection can spread to the rest of the system. 

CAN ANYTHING BE DONE? 

Some folks at Apple are very concerned by tliese (and 
other) security holes, but they (clearly) aren’t in control of 
Apple’s overall security policy. As a result, CSX is ripe lor the 
kind c>f bad pubiicity that MS Windows has recently received. 

As a developer, you have a responsibility to set appropriate 
permissions on your package directories. Do that, and app 
w^on't be part of the problem. Then, file bug reports with Apple, 
asking them to tighten up their own security ht:ies and give 
developers automated feedback and a.ssistance in closing holes 
in third-party applications. 

Several possibilities spring to mind. If rnterface Builder can 
draw helpful blue lines to indicate that a widget is loo near the 
edge of a window, why can’t Xcode (or whatever tool is used 
for package creation) tell the developer when a package's 
permissions are “too near the edge”? 

For that matter, why can't the installation software check for 
this sort of thing? And, while Disk Utility is looking for weird 
permissions and ownerships, why can’t it look for wide-open 
package directories? Like that... 

More generally, when you talk to Apple, tell them that you 
don’t w^ant security concerns to be completely overridden by 
“ease of use” considerations. Both are critical; a proper solution 
won’t ignore either one. 
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Remote 


Dave becomes the couch potato we all 
wish we could be 


Tlie Nc)vembc_T issue; of MacTech is always une of my 
favorites. It*s our annual Gtfl Guide Issue and there's always 
something unusual, something tool, sometliing 1 can cucle in 
red crayon and leave around the liouse For my faidiful family to 
find and buy for ine! 

To start things off this yean we’ve got a humdinger of a gilt 
A bit pricey, but oh will you want one. 

Bull on over to http:// WWW. harmony remote, com and check out 
the ultimate in remote controls, the SST-7Ch The list price is S299, 
but http://www,devdepot.com has it for less than ihac I'm a gadget 
junkie and, without a doubt, this is the l>esl univejTial remote I've 
ever seen. In my opinion, head and shoulders lietter than its 
closest competition. 

What makes this remote so great? hi a nutshell, it's so easy 
to use. I’ve got a reasonably complex setup, with a VCR, DVD 
player, video receiver, laige screen dX and satellite controller 
Each of those components has an as.snciated remote control. 
With a fair amount of work, I've lieen able to program 2 of my 
remotes to control most of what I do with my .sy.stem. And even 
with all that work, there are still siaiations wiiere 1 find myself 
digging out the original remote (such as. changing the screen 
format on my TV from 4:3 to 16:9, or changing the optit>ns on 
my satellite dish). 

And wiien it comes time to change the programming on my 
universal remote, I find myself having to relearn the “learning'’ 
mechanism. Lord help me if I ever have to swap oui one of my 
components. 

The SS7-768, from IrUrigtie Techfioiogtes. changed all than 
When you open the box, you get a remote, a USB nible, and an 
installation CD, compatible with Mac OS X and Windows. 1 ran 
the installer, then ran the newly installed Harmonv Remote 3ipp. 

I opened the preferences and set the download folder to match 
my Safari dowmload folder (this turned out to be imporrant) 
and checked the Watch download folder and Cleanup 
downloaded files checkboxes. 



Figut^ L Ihe SS^f-768 in red. silwn and blue. 

Next, 1 went onto http://vwvw.harmonyremote.com and clicked 
the New User Login link . I filled out a short form, tlien Ragged in. 
Next, 1 w'ent through a sequence of easy steps to specify all my 
components. The web site knew every single one of my 
components, even though some of them are pretty old. 

Then came the important part. Now that i! knew my 
components, the site asked me to pick from a Ii,st of activities I 
wanted programmed into my remote. 1 picked, Watdi a D\T), 
Watch Televisifm, Watch the VCR, and listen to the Radio. I also 
W'ent through the channel listings for my satellite setup and 
selected the channels I wanted on my remote. Once that was 
done, 1 plugged the USB cable into the remote and clicked the 
link that said Update My Remote, 

When I unplugged the remote* I u.sed the scroll wheel to 
select my activity. For example. Figure 2 shows the remote 
scrolled to Watch a DVD. The scroll w'heel is also a button. Once 
you scToli to the activity you w^ant, press the liutton and voila! 
The remote switches all the components to tlie conect settings. 



M A G A 2 I N I 

Get MacTecK delivered to your door at a price FAR BELOW 
the newsstand price. And, it's RISK FREE! 
Subscribe Today! 
www.mactech.com 
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Figure 2 Ckm up shot of the silver SST- 768 

There is a lot more to this remote- ITie web site is an 
inaedible resource. On it, you can customize your settings, even 
edit the XML iissigned to each button. You can create a list of 
favorite stations that you can scroll tlirough using the scroll wfeel. 
Tliere’s a zap button that you cnin press whenever somediing of 


interest Ls on the screen. The remote rememl>ers wliai you were 
watching when you zapped and saves that info for you the next 
tinie you connect the remote to your computer. For now, your 
zap list is strictly made up of the shows you were watching w^hen 
you zapped, hut eventually, the capability to .search the net For 
products whose commercials you zapped could be added. 

You can download program listings onto your remote in 
case you dtm’i have an on-screen guide. And all this is saved to 
non-voiatile flash memory^ so even if you lose your barteries, 
you won't lose your settings. 

If there is a dowm-side to this remote, it is the problem 
common to all macro-driven remotes. It is fairly simple to get 
out"Of-sync with your components. Usually, tliis is caused w'hen 
you press a button on the remote, then turn away or put the 
remote down before the macro has finished each of its steps. 
After a while, you learn to keep the remote pointed at your 
components until the macro completes all of the steps. If you do 
get out of sync, you can use the mode button on the side of the 
remote to address individual components. Amazingly, you can 
use this feature to issue just about every imaginable command 
the original remote was capable of. All-in-all, an amazing leap 
forward for all couch potatoes! 

Intrigue Technologies is in Mississauga, Ontario. You can 
reach them at 866-291-1505 or at www.harmonyrennotesxonn. 

Harmony Remotes are available at DevDepot! 
http://www.devdepot.com/harmony 





It's 3am on Sunday morning. 


Ifi THE fiERVER fiTILL RUNNING? 


End the 
worry with 


L # The simple reliability 

V w solution for Mac OS 9 and X 



System-level Crash Detection ‘ y 

patented hardware-software integration ^ 

Automatic Crash Recovery ^ 

system restart or power cycle, as needed * ' 

Monitor Custom Applications 

software developer's kit and plug-ins included 

Scheduled Restarts 

cures memory leaks and fragmentation 

Restart after Power Failure 

even if shut down by your UPS 

Comprehensive Error Logging . 

to help you track down problems 

Simple Installation 

Just plug in AC cord and USB cable 


For all these features plus six power 
outlets controllable by phone tones, 
schedules and scripts, consider 
our PowerKey Pro 650 A dmin. 


www.sophisticated.com 

/ SOPHISTICATED CIRCUITS 


CDpyrighrt ©2002 Sophisticated Circute, Inc. Kiek'offI and PowsrKsy aeb ragistored trademarks 
of Sophisticated Circuits, Inc. Mac OS is a registered tredetnarkof Apple Cornpuiter, inc. 
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Point 


Apple Wireless Mouse 


My daughters already have iBooks and personalized iPods, 
so what's left for me to give them for Cliristinas? Apple Bluetooth 
Wireless Mouses, tliat's what. Sure, the image of a Bluetooth 
mouse sounds a hit more like October 31 than December 25, but 
t>ace my girls get down from the top of the bookshelf, they’ll 
realize that this mouse is actually rather cute, and very practical. 

The Wireless Mouse is a snap to set up and configure. From 
the time I plugged a D-Link Bluetooth adapter into a USB port 
In the back of my PowerBook-the adapter is a necessary 
cx^mpanion device-it took only thirty seconds to get the mouse 
working. I opened the little users guide that comes with the 
mouse, but only read page 1 before deciding to do it the 
Macintosh Way: by blind guesswork. Yi>ii must have OS X 
version 10.2.6 or better to use the wireless mou.se. If you qualify 
(and who reading MacTech dtjesn’t have the absolutely latest 
version of the Mac OS?), then it's just a matter of putting the two 
AA batteries into die mouse, turning it on, opening the Keyboard 
& Mouse panel in System preferences and clicking on the button 
to configure a new Bluetooth device. The OS does the rest: finds 
the mouse, gives it a name (it named mine ’’williampoiter’s 
mouse”), and kick starts the little dear. I'd say "Plug and play," 
but aside from the Bluetooth adapter, there's nothing to plug! 

1 tried a third-party cordless mouse alxiut a year ago. 1 gave 
it up because it did not seem to me to be as sensitive as a 
traditional mouse. Besides, wddle the mouse itself was cordless, 
there was a transmitter attaclied to the computer by a USB cable. 
So it didn't reduce the cJuner on my desk, just the clutter around 
the mt)uscpad. The Apple Wireless Mouse, however, really is 
wireless: It exchanges signals with the tiny Bluetooth adapter 
plugged into the back of my Pt)werBook. And it seems every bit 
as sensitive as my Apple Pro U5B mouse. In fact, in my hand, it 
feels almo.st identical, which isn't surprising because it's the same 
size and .shape. I say ''almost identical,” because the absence of 
the USB cable does ntake a slight and entirely agreeable 
difference to the feci of the thing as I use it. 

The Wireless Mouse conies in one color: snow^ w^hite. It will 
look great with my daughters' iBooks. Not so great with my 
Titantium Powerbook, but 1 can live with it. At least it's not 
tangerine or chartreuse. 


I 



When 1 first got mine, jealous friends said to me, "What 
about batter}^ life?" Not a problem. In a week of almost coastant 
use, during which time 1 routinely forgot lo turn the mouse off 
when 1 walked away from my computer, the battery life indicator 
in the Keyboard & Mouse panel budged off 100% just once, and 
in retrospect, that seenis to have Ixfen a fluke. The mouse 
automatically drops to low-power when it's idle for a while. Your 
mileage may vary. 1 may switch to rechargeable batteries at some 
point, but not any time soon. 

Re\'olution-wis€, we're not talking wireless Internet here. 
But the eluTiinaiion of any wire or cable is a blessing. And the 
Wireless Mouse is undeniably cool. Hey, don't just give it as a gift 
to others. Buy one for yourself, too. You know you w^ant one. 

Technical specs: 

• The Wireless Mouse requires OS X vlO.2.6 or higher. It also 
requires a Bluetooth-enabled Macintosh, either built-in or 
using the qualified D-Link DBT-120 USB Bluetooth Adapter 
(older Delink DWB-120M adapters are not supported). 

• Apple Wireless Mouse: $(>9 from the Apple Store. 

• D-Link DBT-120 USB Bluetooth Adapter: $49-95 from the 
Apple. This is just one of several Bluetooth options available. 
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Hear 


Audio goodies to please the ear 


For the audiopbUe in yottr life, nothing is better than a holiday 
gift that appeals to theirpnes. Ify^u are on a budget, hotm^er, the 
big super duper extra surround system that telepods a real 

liie syfnphony orchestra into ymtr liimg room Just isn t going to 
make the shopping lisL Never fear, however, as there are optiom that 
are almost as good as tel^rtatum. and slightly more affordable. 

JBL Creature 

It's stmight out of B Sci-Fi flick, only not bad* Creature* This 
three piece, self powered, speaker set from Harmon Multimedia 
defines cool looking. All three pieces have the same bell 
curve/UFO look about them. You get the feeling that if the 
satellites weren't tethered to the F*anh with wire, they'd fly right 
off your desk and back to the home world* Each of the satellites 
has a small LED underneath that lights up, adding to its odier 
worldly appearance. 

Beyond its looks, it is actually a nice sounding set of 
speakers. The Odyssey+ drivers in the satellites push a total 8 
w^atts, while the Magnum driver in the subw^oofer pushes 24. All 
three parts are shielded so they can be close to a monitor or 
other magnetically sensitive hardware. However, the bass the 
subwTOfer pushes enough bass to rattle the image on a monitor, 
.so don't put it too close. 

Set up is pretty' typical for any set of speakers. The power 
button, how^ever, is on the back of the subw'oofen a necessaiy 
evil to keep the looks of the satellites intact, but highly annoying 
none the less, especially if you have the subw'oofer on the floor. 
Likewise, the bass and treble are controlled from the suliw'oofer 
The two spikes sticking up at the front corners are die knobs for 
tliat. At least you have the volume control on the right satellite. 
The controls for volume are quite nice, actually. They are 
pressure sensitive touch pads. Tapping once on either tlie plus 
or minus button will get you a 2.0 decibel inerease or decrease. 
Holding down either for more that half a second will give you a 
continuous rise or decline in 5 decil>els increments* Pressing 
both at die same time w ill mute your speakers. 

The Creatures are a nice *set of small speakers that will fit 
nicely into a small, cramped dorm room, the kids rcxim, or 
anywhere you want to have some .speakers ready to plug your 



iPod into. They have a suggested retail of $129, and come in 
three colors, wlilte, black, or blue. 

Altec Lansing VS4121 

Now tiiese are some interesting speakers. They are not neariy 
as cool kxiking as the Creatures, hut they have a look all tlieir own, 
and wliat diey lack in outlandish .styling, they make up for in pure 
sound. Tliis set is also a 2.1, self powdered unit, with subwcxifer and 
two satellites. Tlie satellites are comprised of tweeters in a sound 
stick type design, with downward firing midrange drivers 
incorporated into tlie base of tlie siitelHie.s. Tlie subwtxifer Ls little 
more than a wooden box, but die impressive 6.5 inch subwoofer 
capable of producing a maximum 19 w^atts tsf powder takes that 
wcxxlen l>ox and pumps out some gcxx.1, deep, ratde your fillings 
bass sound. One note, however. While the satellites are shielded, 
and can l>e placed next to the monitor, the subwoofer Ls not, and 
should be given some distance from magnetically sensitive devices* 
Ail die controls are easily accessible on the right satellite. Volume, 
pcm^'er, bass and treble controls are plainly marked and clearly 
show what their .settings are. It also ha.s a headphone jack next to 
tlie cxintrols, a very nice additirm for those times when you have to 
be quiet. The.se speakers .sound really, really gtxxi. Full sound that 
does justice to any kind of music you w'ould care to pump through 
them* Altec Lansing lisLs them for $129*95, not at all a bad price for 
the nice sound the give you* 


MacAjlly Noise Canceijng Headphones 
Ambient noise can be a problem almost anywiiere. Chatt>^ 
coworkers, noisy kids, roaring jet engines, ifs enough to drive 
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you loopy. In steps technolog}^ with a solution, and cool 
tcchnolog}^ at that. MacAily has a set of noise canceling 
headphones designed to not (inly sound gocxi, but also 
eliminate, or al least reduce, all the noise around you. They do 
tliis by picking up ambient sounds around you, and then 
generate a signal that cancels out the .sound waves from outside. 
It works pretty well, tcK). For most room noise, you wall 
immediately notice a difference. It works quite well on an 
airplane during flight. Take offs w^ill overwlieim the unit, giving 


you a static popping noise in the headset while the engines roar. 
Likewise, under veiy^ loud conditions the noise canceling feature 
will fail, A big old truck with a busted exhaust system will wipe 
nut the capability instantly, 

The hardware is a pretty nice compliment the noise 
canceling technology. White plastics make up the case and other 
pieces of the headset. Batteries go in the right ear cup, w hile the 
controls for power and volume are on the left. The ear cups are 
well padded, and will remain comfonable during extended 
wear, although if youVe got hig ears, you might need to take a 
break from them sooner than other users, ilie cord is detachable 
from the headset, a very thoughtful feature. If you break the 
cord, it is easily replaceal:)le. Try not to do that, though, as the 
included cord has an in line volume control, giving you a break 
from tr>ang to adjust it up on the left ear cup, or digging into 
your pocket to adjust it on your iPod, There is also an adapter 
for plugging the mini jack into an airline seat audio jack, bist, 
the headset folds up and fits into a compact little carry case, a 
cool feature over some otlier headsets of similar type, and at 
around $70, MacAlly beats them all on pnct^. 

Conclusion 

Whether you want to give that special someone a nice set 
of speakers, or have on your wish list something to let you tune 
out the world around you, any of the above audio systems wall 
serve you and yours w'ell. Tlieir prices won’t max out your credit 
cards, either. 


Expand your LAN 



TrangoLINK-10^^ Outdoor Wireless Ethernet Bridge 


* 10 Mbps up to 40 Miles 


* Easy to Install 


* Easy to Manage 


♦ Secure 


Expand your existing LAN in hours! The TrangoLINK-10 point-to-point outdoor wire¬ 
less Ethernet bridge offers secure, high-speed transmission in the license exempt 
5.8 GHz and 5.3 GHz bands. Ideal for building-to-building connectivity, the TrangoLINK- 
10 can be integrated into existing networks for a low-cost, scalable LAN expansion 
solution. 
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Phone: 858.653.3900 
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Toys 


Cool toys for grown up^ and not so 
grown up, geeks 


Sony AIBO 

When the AIBO robot dog was first released some years 
back, its birth was met with some cynicism regarding just how 
realistic a dog replacement the robot could be. Since those early 
days, the AIBO line of products has continued to develop and 
there is now a mnge of different mcjdels for different types of 
consumer. Althougii similar in many ways to a dog, the AIBO 
robot has been likened to a new life form that shares dog 
attributes, but benefits from being a robot (such as rotating its 
legs a full 360 degrees; a feat that drsgs C 2 in certainly not do). 

The AIBO rolxKs comes in a variety of forms frtjm the lower 
cost Macaron series with fewer sensors and capabilities to the 
ERS-210 series witli more sensors and robotic dog styling. 
Additional models include the futuristic looking ERS-220, with 
even more Features, to the brand new ERS-7, that includes a built 
in wireless card and improved sensors. 

AIBO robc3ts are very flexible machines and are comprised of 
a number of limbs and sensors that allow you to interact with 
them. In addition to these sensors, the AIBOs include temperature, 
distance and visual sensors to ensure that the robot always knows 
what is going on around it. The main AIBO units are very well 
built and are pretty sturdy, although it is not recommended to take 
your new cyber-pal out for a walk in a muddy field. 

The range of emotions and responses from the AIBO is 
dependent on its brain; the Memory Stick cooUiins the AIBO W^tre 
software to bring your AIBO to life, 'IliLs range of software includes 
the AIBO Life 2 product in which your AIBO stairs life as a baby tliat 
cannot stand up or walk and needs constant attention, just like a real 
child. As you spend more time witli AIBO, it will grow up and gain 
more skills such as standing, then wdking, and then ixrcome more 
inquisitive alxiut its surroundings. Included witli tlie AIBO is a pink 
\ia\[ in a teenage AIBO can kick around and tap. Anotlier AIBO Ware 
prcxiuct is die Explorer memory stick. This pnxluct provides a fully- 
grown, inquisitive AIBO, witli more capabilities and responses. A 
recent product lias l^een the AIBO Recognition stick which will 
allow AIBO to recliafge itself when it needs power by gtiing over to 
the chaiging station (sold separately ) and .sit down to chaige. Wlien 



AIBO is chaiged, it will get up and wander around as normal. Tlie 
new ERS-7 rolxits are taking the AIBO conc’ept ftirther and include 
extra sensors (electro-static sensors diat do not require pushing in), 
more LEDs, panem recognition and fJie ability to pick up a small 
Ixjne widi its mouth. 

Although certainly not cheap, the AIBO line of robots is a 
fantastic gift for someone who loves gadgets and electronic toys, 
and playing with AIBO is a true joy. The only problem you face 
Ls getting too attached to your litde electronic companion..,. 

PiayStation2 Eyetoy 

Within tlie realm of game CQnsole.s, there have been many 
attempts to vary how you control the on-screen action. Attempts 
have included light guns, infra-red sensors, steering wheels, and 
dance mats, among countless other gimmicks. Recentl y, I have 
tried a new contender in this area, one that not only changes the 
way you use your PlayStacion2, but is also incredibly fun. 

The Eyetoy is a small black w^eb camera that plugs into a 
USB port on the front of the console. Included in the package is 
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a game disc that has over iO mini games where you interact with 
on-screen characters using yourself as the controller. The games 
on this disc vary greatly in what you need to do, but higlilights 
include the soccer game in which you keep a ball in the area 
using your head, a boxing game in which you fight a robot and 
a karate game in which you fight off legions of miniature ninja's 
intent on kicking you in the head. 

Tlie Eyetoy Ls not only a fun addition to your PlayStation2, but 
is immensely fun to use. When 1 first received tlie unit through tlie 
pcrst. T was expecting it not to work quite as well as I was 
anticipating. To my surprise, the EyeToy works very well at 
inteipreting your image and actions witliin tlie game tliat you are 
playing. As Ls the cuse with the dance mat, lire Eyetoy really comes 
into its own at parties and gatherings as you marvel at Uncle Bill 
punching at thin air. If you want to make a fool o( yourself and have 
some great fun wBile doing it, the Eyetoy is highly recommended. 

PiayStation2 Network Adapter 

When the PIayStation2 was first released, there was much 
fanfare atxjut its up and coming network gaming abiliiies. As is 
typical with commercial products, the network adapter was held 
back for quite some time before its eventual release. The finally 
released adapter is a sleek black box that slots into the back of 
the PlayStation2 and provides the various necessary network 
connections. If you are based in the USA, there are modem and 
Ethernet connections, and if you are based in Europe, you get 
just the Ethernet port. 

Included with the nemork adapter is a start-up disc that to 
get you connected to the Internet and some softw^are to access 
the PlayStation2 gaming portal from your console. Settings for 
your network access are stored on a memory card, and the start¬ 
up disc has a number of DSL/'Cable providers already included, 
so installation is a snap. 

The range of online games capable of supporting die 
adapter is increasing all tlie time, and a number of publishers 
liave confirmed titles tliat will be available in time for Christmas. 
One of the most popular of tiieae games has been SOCOM: Na\y 
Seals; a first person perspective action game that includes a USB 
headset witli which you can talk to your team members to 
develop attack strategies. 

The network adapter is ushering in a new era of game play 
for PlayStation2 owners. Although the other consoles have their 
equivalent products, the Play$tation2 has secured a number of 
publishers to create online content, and it looks as if online 
gaming will be a pre-requisite in future game titles. 

Belkin 54g Wireless Access point 

Wireless networking is fast becoming a standardised and 
popular method for networking machines together in the home 
and small office. The most common method used to implement 
a wireless network is to buy an Access Point and plug it Into 
your LAN. Altliough a simple .solution, access poinLs liave been 
limited to the 802.11b standard which can transmit data at 
llMB/s; suitable for sharing internet connections and small 
amounts of data, hut not suitable enough for transferring large 
files across your network. 


The Belkin 54g Access Point was one of the first products 
to implement the 802. llg, or Apple monikered Airport Extreme, 
standard. The unit actually implemented the draft standard 
before that standard was finali.sed. Despite that, it works well 
with products using the now finalised 802 llg standard. 
Additionally, an upgrade patch is available from the Belkin 
website. This standard increases the bandwidth of the unit to 
54MB/S and still suppons 802,1 lb devices. It is important to 
remember however when discussing wireless devices, that 
ilMB/s and 54MB/s refer to the fastest theoretical possible 
speed, and obstmctions such as walls, ceilings and doors can all 
reduce the signal throughput of the access point. 

The Access Point is simple to install and merely requires 
plugging it into tlie back of a hub or network card. The unit 
provides you with a variety of features such as ^^P and WPA 
encryption, MAC address filtering, upgradeable firmware and a 
variety of other features, all controlled by a web based interface. 
With the unit plugged in you just need to obtain an IP address, 
and you can connect to die network. 

For most home users, wireless technology is useful for 
preventing unsightly cables l>eing dragged around the house 
and drilling holes in the ceiling for computers upstairs. Although 
not the most expansive of access points on the market, tlie 
Belkin 54g provides a simple means of getting your wireless 
network up and running in no time at all. If you are going to 
consider giving this as a present or asking your nearest and 
dearest to get you one, don’t forget to also include a request for 
one of the Belkin >4g network cards (PCMCIA and PCI version 
available) so you can connect as fast as possible. 
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GIFT GUIDE FOR 
GEEKS 2003 


By Michael R. Harney 


Gadgetry 


Just cool atui interesting stuff to give or get 


'fhere is alimys a large sekainn ofpimibk stuff togim or get 
during the holidays. From halb tomls, to luxury* SliVs. Following 
are a few choices that fall somewhere in fxdmen those extremes. 

EBookEndz 

The folks over at l^holo Control Corporal ion 
(www.bookendzdoclc5.com) have iheir fingers in several pies. The 
one that we are most happy with is the Bcx>kBndz line of 
products. For years now\ these guys have been making docking 
stations for many of Apples laptops, from the 1997 G3 all the 
way to the current 12 inch aluminum PowerBook. We looked at 
the one they have for the Dual USB iBook. Ifs a small, compact, 
rectangular box that simply plugs into the ports on the left skk 
of the iBook. It is available in lx3th wliite and black. And, it ju.st 
works. Pkig the BookEndz into the ‘Book before turning it on, 
and you are set. Plug once, instead of two, three, or twelve 
limes. IPs really, really, handy. FireWire, USB, network, and 
modem are all there. Tlie RGB connector un the iBtJok is 
converted to a VGA connector to make it easier to attach un 
external monitor. Likewise, die A/V connector is converted to 
RCA jacks for audio left, right, and video. The only caveat with 
the iBookEndz is that it won't work with s-video on the iBook 
May 2002 model. Tlie w^hite colored iBookEndz is $159.95* and 
the black colored dock is $144.95. Anyone who has a 
PowerBook will find one of these docks incredibly useful, and 
would just love to get one for the holidays (liint, hint). 

Visual THESAURifs 

This application began life as a welvbased tool in 1998. 
Since then. Plumb Design (www.vfsualthesaurusxom) updated it, 
and released it as a stand alone product earlier this year. Visual 
Thesaurus, as its name indiaites, provides you with a graphical 
way to find words, their meanings, and their synonyms. It uses 
the WordNet database provided by the Cognitive Science 
Laboratory at Princeton University (www.cogsd,princeton.edu/-wn/). 
It handles English language words only. 

It is, if nothing else, a unique approach to looking up 
words. While moving over to anodier program in order to look 
up a word is less than ideal, having to move over to tliis program 



may make it not quite so bard to deal witli. Can you find the 
synonym to tJial word to need to make deadline? Sure, although 
liecause of the grapliical nature of the presentation, it may lx? 
more difficult than usual to find exactly w^hat you are looking for. 
Tliai doe.sn't necessarily seem to be the point of this program, 
hoW'CVer. 1 found myself just expkxing related links to words that 
jumped out at me. It beeame a fun sort of game to follow along 
a random .selection patli to find out what would pop up next, 

Vi.sual Thesaurus is available directly from Plumb Designs 
web site for $29,95 (plus shipping and handling if you want Lfiem 
to send you a CD), 

Transpod 

When the guys at Netalog, Inc, (www.everythingipotJ.com) came 
out with the Transpod, 1 thought it was, hands down, the best 
iPod accessory ever created, 1 still think that. This device is a 
combination FM transmitter, and iPod charger for use in your car. 
It plugs into the cigarette lighter of your vehicle, eliminating the 
need for any cords or wires. It can he set to any FM frequency 
to allow' you to broadcast your tunes on your car stereo. By law, 
the transmitter is very low power, so you pretty much have to 
have die volume nearly maxed on your iPod, and radio, in order 
hear the music. Tlie kit comes with the main body of the unit, a 
mounting bracket (if you want to screw' a liracket to your 
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dashboard), a power cord to plug the dash mount into power, 
the articulating arm for plugging tlie unit into a car power 
adapter, and last, an extender arm so you can place the 
Transpod in a usable position even when your cars power 
adapter is in an out of die way location. The one thing to note 
about the arms is that while they can be adjusted up and down, 
there is no left and right articulation. This proved to lie 
somewhat distracting when tiydng to read the screen, and having 
to lean over to do so. This device is $89 99 direct, 

Thar's not all, however. Soon after the release of the 
Tmnspod, Netalog came out with the Transpod 2. Similar to its 
predecessor in ap[iearance, but designed to give you a one 
piece solution to hold and charge your iPod, while letting you 
plug the setup into either a cassette or direct audio plug. Hiere 
is no FM transmitter in this model, but for what it does, you don't 
need one. IT conies witli the same parrs as the original, hut also 
adds the cassette adapter, and direct connect cables. Obviously, 
a direct connection garners better sound quality than FM, so you 
get as good a listening experience as your car .stereo system can 
produce. This version of the Transpod is available for $59 99. 

FireWire 800 Hard Drtvt 

The folks at WiebeTech are the answer to many technicians 
dreams. They have a range of products designed to make the 
administrators life a little easier. I'lie MicroGBSOO hard drive 
(vwwv.wiebetech.com) is a tally outstanding gift choice among their 
offerings. This miniature portable drive has dual daisy chainable 
FireWire 800 interfaces, and a USB 1.1/2.0 interface. It can be 
either bus powered, or run off the included AC adapter. A 
FireWire 800^800 cable, FireWire 800-400 cable, and a USB2 
cable are also included. USB tjperation requires the AC adapter. 
The drive is plug and play without drivers under OS 9, and Mac 
OS X (you can bool from this drive on the Mac OS), not to 
mention Windows 98SE, ME, 2000, and XI^ A very' nice carrying 
case is included, which gives the drive case a bit of protection 
from scratches. FireWire 800 operation requires a FireWire 800 
ho.st, otherwise the connection speed will revert to FireWire 400 
automatically. 

There are a range of options and pricing for this drive. 
Starting at $159.95 For an empty, install your own drive, case, 
up to $449.95 for an 80 GB 4200 KPM drive. There is one 
higher option that WiebeTech recommends for getting the 
most out of the FireWire 800 connection. A 60 GB, 7200 RPM 
drive for $529.95. Anyone w'ho needs to move a lot of data 
around, and needs high speed access to it wall find this 
stocking stuffer invaluable. 


lSl*EEVE 

The iSleeve is Terforma's entry into the iPod accessory 
tiiarket. These folks have produced a carry case for both 
original and newest iPods that is supposed to be ""a sleek, 
protective rubber case for biisiness-to-sport versatility, but also 
unfettered access to the iPod’s dial interface and display” 
according to the press release. And that is a fairly accurate 
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description of the unit. The main rubber case that surrounds 
your iPod Ls fairly sturdy, as is the plastic back panel. Tlie 
rubber has openings to allow you access to the ports on the 
iPod. The case has even been molded to allow an iTrip from 
Griffin Technology (www.griffintechnology.conn) to plug in without 
removing the case, a nice touch creating a product to allow 
easy use of other company’s stuff. Installing your iPod into the 
case is simple. Visual instructions are provided, as are padded 
strips to help get a custom fit for your pariicular iPod. Getting 
the iPod in and out is easy, but the case still htdds it securely, 
so you don’t need to w'^orry about it falling out. The back panel 
has both a belt clip, and a hand strap for holding it while 
exercising. It is also designed so that you can store your ear 
buds out of the way, but easily accessible. Getting the ear buds 
in and out takes a bit of getting used to , but it’s not 
iiiipossible. Access to the dial and buttons is better than most 
other cases and sleeves for the iPod out there. The iSleeve 
comes in black and white, and has versions for both the 
original and new' iPods (named G1 and G2 respectively). The 
iSleeve is available directly from Terforma for $49.99. 

FriendlyNET FR1004AL Wireless Roliter 

Okay, so the 802.1 Ig wirele.ss standard, nee Airport 
Extreme, is tlie coming thing, Tfiat doesn’t mean, however, that 
the 802.rib standard is ready to be cast aside. There’s a ton of 
plain old Airport need .still out there. Over the last several 
months, I have looked at several different 802.llh wireless 
routers. The FriendlyNET FE1004AL was my {>verall favorite. 
Many of the models ! checked out had something to recommend 
them as well as detractors, the Asante offering included. The 
FR100'4AL came out ahead overall, with the lies! set of features, 
and the fewest issues to complain about. Physically, this router 
is great. The case it good, sturdy metal (not flimsy plastic, like 
most others). The antennae screw on securely, and are also of 
good quality. This router was the only one 1 tested that had four 
pons on it. Most had only mo. So, for the FR1004AL, you most 
likely w'ouldn’t need to put a hub in to handle multiple 
computers. The range on this teast is great, better than any 
other router 1 tested. I literally walked out my front door witli 
my iBook, and down the street a full block before losing the 
.signal. It’s got really good signal strengtli, too. A few others had 
higher overall signal strength, but none had that in combination 
with its range. On the inside, the software is uber simple to set 
up. It almost does itself. And, that’s about where it ends. With 






this router, you don’t have the depth of settings you have with 
some of the (Jther offerings out. That said, what you can do with 
it is likely more than enough for most. Everything is done via 
w^elD interface. This router is definitely the perfect gift for that 
special someone who needed to unplug form the wall. The 
FR1004AI can be found at many online stores for $90 to $100. 

CinemaLifi Arm 

Now this one is really ccxjI. One thing about the Apple displays 
tliat always bugs me is their very limited adjustability. This 
product takes care of that pr{)blem in marvelous fashion. 
Innovative Office Products (wwvv.lcdarms.com) has several 
different styles of lift arm.s for taking LCD monitors up off the 
desk, and they have created one specifically fcir Apple Cinema 
and Studio Display.s. These ridiculously sturdy, metal arms have 
360 degrees of swivel at all three joints, provide 18” of vertical 
movement, 27” of horizontal movement, and 200 degrees of till. 
Wire management is handled by threading cable through the 
arm itself, or via plastic snap on ducts, and clips. The kit has 
easy to follow instructions, and all the parts, and tools, necessary 
to pm the lift arm together to get it off the table. The only 
alteration you need to make to the Apple display is to remewe 
the rear support ami by taking our three screw^s, then pulling off 
the arm, and a plastic cover From the hinge. One cool thing 
about the kit is that parts are included to mount the arm any one 
of several ways. It can be either wall mounted, mount to the 
desk with a clamp, or anchored to the desk, if you are willing to 
drill a hole into it, among others. Once the device is assembled, 
you will need to turn a few screws to get the tension, and 
pneumatic cylinder adjusted for the weight of your display, but 
that’s it. Your LCD is floating above your desk, and can be easily 
adjusted to any height and angle you need. 

Tliere are two version of tlie arm. Tlie Cinemalift is for the 20 
and 23 inch displays. The Siudiolift is for the 17 inch Apple 
display. Tlie cost of the CinemaLift is $369 with the StudioLift 
being somewhat less. 
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By John C. Welch and Michael R. Harvey 


See 


If seeing is believing then believe these 
are great gifts 

Introduction 

Well, as the gift giving season rapidly approaches, we hit the 
decision that faces everyone who knows a Mac user...what tlie 
heck to buy them that won't break the bank? Well, thanks to the 
efforts of at least two companies, there's an easy gift for any Mac 
user with a reasonably fast machine: a FireWire web camera. 

The iSight 

As anyone who hasn’t been living under a rock knows, tlte 
Apple iSight, and its attendant iChat AV softw^are, has suddenly 
made video conferencing fun for people who aren’t geeks. Now, 
Apple didn't invent videoconferencing by a Icmg shot, but thanks 
to a willingness to go the extra mile, there is now a package that 
makes it far less painful. However, this is not an iChat AV review, 
even though it's an obvious topic when you’re talking about the 
iSight. We’re going to attempt to talk more about the cool things 
you can do with the liardware. 

As part of that, we should probalrly cover the ver>^ few 
things you can’t do with it, namely use it with iMovie, Final Cut 
Express, or Final Cut Pro. Tlie iSight doesn't use the correct 
signal type for those applications to talk to it. However, that 
doesn’t mean you can't make use of an iSight if you have those 
programs, it just means you have to use an intermediary 
application, some of wliich we'I cover latcn 

Basics 

The iSight resembles.. .well, an electric razor with a lens 
instead of a handle. It's a cylinder, alx)ut diree inches long, and 
around an inch or so in diameter. It uses FireWire for it’s 
connectirm, and comes with a set of strain relief/mounting dips 
that wrap around the included FireWire cable to help secure the 
iSight to the three mounm that are included with the camera, and 
brings us to our first of two complaints about the hardware. 

First of all, the clips that secure the iSight Co the mc^unts are 
pretty cheesy. Wliile we understand that Apple had to make 
them easy to disassemble, in the months we'%^e had the iSighi, 
we’ve almost lost the two pieces many times. They slide together 
around the cable, but until they are attached to the iSight, they 



come apart far loo easily, and are too easily lost in the depths of 
a laptop bag. They really seem to have l>een designed for 
someone who will mount the iSight once, and never move it 
from that mount. This makes sense when you consider the 
mounting hardware. 

The iSight comes with three mounts, one for laptops, one 
for Cinema Displays/iMacs/LCD displays, and one for 
eMacs/CRTs. Now, the laptop mount is pretry sweet. It clips 
onto the top of the screen, so it's at the all important eye 
level, and has a knurled thumbscrew^ to securely clamp the 
mount, and the iSight to the screen. The design is well 
thought out, and doesn't intrude into the actual display area 
of the laptop screen, even on a TjBook. However, the other 
two mounts are not nearly as well thought out. They attach 
via two “ sided tape, so once you attach the mount, that's 
where it stays. Let's review^ this: you buy a $149.00 camera for 
someone who owns a multi-thousand dollar Cinema Display, 
and you want them lo glue the camera to the display. Um, no. 
Even without the aesthetic concerns, adhesive mounts are a 
right proper pain if you ever have to readju.si them, and we 
have yet lo see an easy source for just mounts. Come on 
Apple, you win awards around the world for industrial 
design, and your solution for using an iSight with anything 
but a laptop is three bucks of Lucile and carpet tape? It 
definitely puts a damper on the user experience. 
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Using the iSight 

That aside, however, the iSight itself is a handy bit of work. 
It's unobtrusive, and has a very obvious, (and very welcome) 
way to tell you the lens cover is closed, and the camera shut 
off. When you rotate the end of die case counterclockwise, a 
white lens cover snaps into place. Perfect for those times when 
you don want the world to see you in the flesh. The auto focus 
works well enough ft)r it's intended use. You aren’t going to 
film a football game with it, hut w'hy would you want to? While 
iChat AV may not allow you to adjust gamma, and other values 
for the camera, there is other .software, such as (QuickTime 
Broadcaster that can, 

The Fire-i 

The Fire-i web camera, from Unibrain (www.Linibrain.com) is 
almost the anti - iSight. It is highly compact, $50 less than the 
iSight, and needs only one extra mounting part, which you'll 
likely leave attached to the camera once installed. The Fired, 
with the clip attached, is a cube about 1.5 inches to a side. It has 
two FireWire ports on it, making it very valuable for mobile 
users, You can plug the cam in, and still have another FireWire 
device attached through it to your PowerBooks single FireWire 
port. The Fire-i can accept power from either the bus or you can 
plug your owm powder directly in to the cam. It has a manual 
focus control, and no shutter. 

This camera was designed mainly for use with laptop 
computers. Its dip will hold the cam to most any laptop screen, 
and even has pins Lnslde it so that the camera won't slip too far 
down on the screen case, avoiding the possibility of it pressing 
down on the screen itself. The clip, which swivels 360 degrees, 
also has a great deal of tilt capability. 1’his allows you to set it 
up on a desk, or monitor. 

There are tw'o areas where tlie Fired comes up a bit short. 
One is that it lacks a built-in microphone. In order to use voice, 
you have to either use tlie built-in mic on an iBook or 
PowerBook, or attach a tlurd party microphone. Tliis not a deal 
breaker by any means though, as the high picture quality, and 
portal.'tility more than make up for this missing feature. The 
second issue we ran into concerns the focus knob that surrounds 
the lens. This more of a warning than a complaint. The spring 
in the clip is pretty strong, and it takes a bit cd' work to open it 
up. Your thumb will naturally fall on top of the focus knob when 
you are squeezing tlie clip open. When we did this, w'e jammed 
the knob straight into case of the camera. Every diing still worked 
fine, but a small clip broke and now the ftxus knob can slide in 
and out of the case along the tens. Be careful not to put any 
pressure on that knob. 

There is a nice set of software gcx)dies liundledwith this 
web cam. BTVTro (discussed below), as well a few others. 
WuffCam (wvyw.WLiffwtiffware.com), web cam software designed to 
broadca.st images tcj Rendevou-s capable browsers, or upload 
images for the web, as well as a few other features built in to a 
simple interface. A beta of SecuritySpy (www.securjtyspy.com), a 
video surv^eillance application with features .such as multiple 
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camera support, motion detection, and live video streaming over 
networks. And last, the ISpQ Video Chat client. 

Despite not having a microphone, the Fire-i is great little 
camera, with superior image quality, and a nice bundle of 
software to use with it. And, of course, it works flawlessly 
with iChat AV. 

Software 

Once you get past iChat AV, tliough, there Ls a lot of really 
neat stuff you can do with one of these cameras. They work 
perfectly witli QuickTime Broadcaster and Quick! une Streaming 
Server, so if yoti want to set up a web broadcast to more thari 
one person, or set up a .streaming wet) earn, then just install 
Broadcaster and tlie streaming server, and yoLfre set. (Wliile ytai 
normally have to buy Mac OS X Server to get QuickTime 
Streaming Server, just dovvnlciad Darwin Streaming Server if you 
want to use it with Mac OS X J, It takes about five minutes to set 
up Broadcaster and QuickTime Streaming Server, and once you 
do, you can talk to mUlIons, just like Steve at a keynote. This is 
also quite handy if you want to set up a hidden camera system. 
Gel some cameras, some iBooks, (while an iBook is marginal for 
iChat AV, for QTSS, lt“s fine), place the cameras, and youVe got 
a nice little QuickTime Surveillance System dial you can use 
from anywhere with a decent internet connecticjn. 

However, if you want to use either web cam as a low - 
budget FireWire DV cam, you can do that with a handy little 
package called HTYPro, from Ben Softw'are, 
(www.bensoftware.conn), BTVTro allows you to use the iSight or 
Fire-i as a DV Cam of .sorts. It also has a really excellent 
motion detection system that can turn on the camera and 
record when the motion in the camera's field of view^ hits a 
predetermined threshold. Just the thing for making sore your 
roommate is staying out of your Cheetos stash. Even better, 
BTVPro, unlike iMovie or any video editing applications from 
Apple is scriptable, including the motion detection, codec 
selection and settings, and DV Tape device control. So with 


BTVPro, you can record the video from the Fire-i or iSight to 
a DV Tape, and because iPs scriptable, you can control this 
from other applications. Again, while security/surveillaiice 
may not necessarily be a common use for one of these 
cameras, with the right software, it would be a very functional 
link tool for this kind of work. John has some law 
enforcement friends who are rather interested in using an 
iSight for just this purpose. 

Video Conferenong 

Since we have mentioned iChat AV a few times, we should 
talk a bit about how well the iSiglir and Fire-i perform as 
videoconferencing tools. ''Quite welT would be the smarmy 
answer. They really do a serviceable job, and iChar AV is one of 
tlie easiest applications to use for tliis kind of task. The only 
tiling we would say Ls that if you are going to use iChat AV a 
lot, we’d really recommend getting a headset / mic 
combination. The iSighi's internal audio dreoitry can get a little 
overworked if there’s a lot of background noise when you are 
talking to it, never mind that the Fire-i has no audio capability 
at all, and requires other hardware for audio input. We have 
used the PlainTronics 300 USB headset with tliem to great 
effect, especially the mule button on the headset! Besides audio 
quality, a good headset allows you to avoid the temptation to 
turn an iChat AV session into a long distance phone call to 
Europe circa 1949; “WHAT? HOW ARE THE SQUIDS? WE 
DON’T HAVE ANY SQUIDS ...OH, KIDS...THE KIDS ARE 
FINE...NO, NOT IN LIME, FINE!”. Just be careful with the 
distance between the mic and your mouth, or you end up 
sounding like a reject from a Darth Vader audition. If you need 
to video conference with folks who don’t have iChat AV, your 
options are a bit more limited. Yahoo works well enough for 
video, hut we have yet to get the audio to work on that 
program. There are some others, like SquidCara, but again, both 
sides have to have the same program in most cases, so if you 
want to do a lot of videoconferencing, some judicious research 
into what the people you will be talking to are using is a good 
idea. As is bandwidth. While in theory you can get at least voice 
chat to work over a 56K dialup, iPs going to be very spotty, and 
sound ratlier poor. You really need at least a decent DSL or 
Cable Modem connection if you are going to be using any of 
these web cams tor more than a few seconds at a time. 

Conclusion 

As gifts go, you can do a lot worse than one of these web 
cams. The Fire-i is a good option for full time Pow^erBook 
users, as it is very small, and you already have a mic 
integrated into the Fow'erBook. The iSight is a great choice all 
around, even if it is rather bulkier than other cameras. They 
are relatively inexpensive, work well, and can be put to some 
fairly innovative / demented usage. .And if you really want to 
make a MacTech columnist’s week, w^eO, John will happy to 
help you widi that. Just use the email address at the top of 
the article ;-) 
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Effective source code control and defect tracking require powerful, 
flexible, and easy-to-use tools—Surround SCM and TestTrack Pro 


■ Complete source code control with private 
workspaces,automatic merging, role-based 
security, and more 

^ Comprehensive defect management — track 
bug reports and change requests,define 
workfiow, customize fieids 

‘ Fast and secure remote access to your source 
fiies and defeas — work from anywhere 

»Advanced branching simplifies managing 
multi pie versions of your products 


■ Link code changes with defects and change 
requests — know who changed what, when, 
and why 

■ Scalable and reliable cross-platform, 
client/server solutions support Mac OS X, 
Windows, Linux, and Solaris 

‘ Exchange data using XML and ODBC, extend 
and automate with SOAP support 

»Licenses priced to fit your budget 


Sitjpinr 
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TestTrack 
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Seapine Software Product Lifecycle Management 
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By Ilene Hoffman 


Share 


The gadgets to help you share those 
moments of life 


How often do you take pictures at a gathering, and promise 
to send copies of the prized photos to the odier folks? Do diese 
copies ever make it to your friends and family? My guess is no. 

So, my first gift recommendation is, of course, a nicely 
priced digital camera. Generally speaking, you can't go wrong if 
you buy a digital camera from any of the major companies, such 
as Canon, Olympus, Nikon, Fuji, Pentax, or even Sony. [ own 
old Fuji and Olympus digital cameras, and IVe been very happy 
with both of diem. I also own Olympus, Nikon and Pentax film 
cameras, but won’t buy another Olympus film camera. Three of 
the Olympus film cameras Fve owned didn't make it past the 
.second year of use without (ireaking. My liasic Olympus Stylus, 
with a glass leas has performed W'ell and I recommend it highly 
for a little travel camera (about S8G). 

Olympus digital cameras seem a bit more robust and wath 
their zoom capabilities are more versatile. My Dad swears by his. 
Nikon's Coolpix digital cameras are highly praised by their 
owmers (and 1 know^ quite a few^). One of the recent Nikon 
CoolPix cameras, the 5400, is particularly nice> ll is practically a 
professional grade camera, with a full range of hi actions, as well 
a.s add-ons and lenses. The S400, however, doesn't quite fall into 
the nicely priced category. IVe found die Fuji digital cameras to 
perform exceptionally w^ell in poorly lit situations. 

The bottom line is, you need to try^ die c'ameras out at a store 
prior to buying. I’m very picky about the eye piece and prefer 
Nikon's viewfinders. You should also Itxjk for a digital camera 
that is has at least a 3 mega-pixel resolution, so that you can 
produce good looking prints. Low^er resolution camems are ok 
for posting r)nto the Internet, but you can’t really edit them to 
produce a decent 4x6 close up shot, A 3-megapixel camera can 
produce a g(X)d 8x10 photograph, if needed. Digital Camera HQ 
has a comparison page of many 3 mega-pixel cameras at: 

www.digitalc3mera'hq,com/3-megapixel’digita!-camer3s-ratings.html 

Although, I’m usually not prone to recommending stores, I 
do w'ant to make note that the Idtz Camera chain has an 



honomble 30-day money back gtiaraniee, even on expensive 
camems. Most retailers only have a 7 to 10 day return policy. 

If you have a digital camera, there’s an easy solution to the 
“Where's that photo you promised me?” problem, which is my 
second gift recommendation. Hewlett Packard makes this litde 
2.9 pound printer that is a mere 9.r' x 4.4" x 4,9/ so it can fit 
into computer bag ea,sily. The 11? Photosmart 245 compact photo 
printer has built-in slots for every type of digital media 
(CompactFlash, Microdrive, SmartMedia, Secure Digital, 
MukiMedia, Meintjry Stick, and xD-Picture Card). The built-in 
1.8-inch LCD screen alkjws you to scroU through your pictures, 
do basic editing, and pick and chcxise your prints. A contact 
.sheet with tiny thumbnails is also a print option. Basically, you 
just plug in the printer, pop in your media, hit print, and you4e 
gtx)d to go. Can it get any easier than that? 

The printer Is last, convenient, prints excellent quality pictures 
on Epson and HP 4" by 6" photo j:>aper, and is one of die simplest 
printers to set up that f've ever used. It is a little pricey with a 
$199.99 MSRP, but if you want to forego the LCD display, you can 
get the Photosmart 145 for $149.99. The LCD screen makes the 
stand-alone unit more usable, lliough. Both models also connect 
to your computer widi a USB cable that you supply. 

Sharing those captured moments of life i,s always a great gift, 
and giving, or getting, the cool tools to do it is even better. 
Nearly any digital camera, and one of these printers, will turn 
you into a one person, photo producing machine in no time. 
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Density optimized rack mounted Mac OS X Server 



UNIX-based Server Solutions from Apple 
Nearly half a terabyte of storage per lU 
630 gigaflops of processing power 
Hot-Swappable drives 

Industry-standard lU rack-optimized design 


There has never been a better time to buy... 

Small Dog Electronics carries 
factory refurbished models too 
offered at substantial savings! 

(subject to availability) 



Small Dog 

Electronics 

www.smalldog.com 


1673 MainStheet. Route 100, Waitsfield. Vermont 



Apple Specialist 


To learn more: httpy/www.smalldog.com/xserve/ 




















































































Enhance your knowledge and 
skills by attending the world's 
most comprehensive forum 
for Mac users. Transcend your 
boundaries and make informed 
purchasing decisions. 





J<?vv\iA«nvy ZOO^ 


FvdnHClSco, CA 

TUe Moscovve CenVev 



Conference January 5-9,2004 
Expo January 6-9,2004 


Find out what all the buzz is about at 

www.macworldexpo.com 


Macworld 

Conference & Expo 


■IDG 

WORLD EXPO 


Flagship Sponsors: 

Macworld 









Macworld Conference & Expof 20 years 
young, will deliver you a universe of 
solutions for all your Macintosh needs. 
Don't miss your opportunity to experience 
everything Mac in one place! 

♦ Acquire knowledge to stay competitive 

♦ Test drive new and innovative products 

♦ Network with like-minded people 

♦ Talk with the companies that make 
you more productive 

♦ Feel the power of this holistic community 

♦ Enjoy the atmosphere 


Register online with 
Priority Code: A-MTN 


Macworlll.COlll %MacCentral 
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Fun time 


You simply can't spend ull your time in serious wcjrk siull 
I don’t eare what the 7 IlabiLs say, sometimes you jtisi have to 
goof off. No doubt you have heard of the liig boys in the gaming 
field, Aspyr, and MacPIay. They aren’t the only one out tliere, 
though. Following are a couple of options you might not 
normally run across. 

Spaceward Ho! 

Back in the day, my Ixiss bought version 4 of this game for 
all the senior staff in the office. Countless hours were lost 
playing this addictive little strategy game. Earlier this yean Delta 
Tao finally released version 5. It’s a Carbon app for botli OS 9 
and Mac OS X, and Eve once again lost more hours than 1 care 
to tiiink aliout to this game. 

As 1 mentioned, diis is a strategy game. The basic idea is 
galactic conquest. The interface is very intuitive, and easy to 
figure out. Yau spend your time enjoying the game play, not 
supervising the minute details of empire l>uilding, and resource 
management. You build your fleet, move from planet to planet, 
beat off your enemies, terraform the worlds you can, and strip 
mine the ones you canT Sliders let you set how much of your 
resources you will save and spend on technology', with that 
amount being divided among what type of technology you want 
researched. The game is turned based. So, you liuild, move, and 
do all the tilings you need to, then end tlie turn. After that, the 
other ctmiputer players go, and you get tlie results in messages, 
and battle scenes once your turn comes around again. A nice 
feature of the game is Internet play. You can hook up with 
others on the Internet, and battle them directly, giving you 
something besides computer controlled fipponeot once in a 
while. The graphics are simple, but eye catching. This really a 
fun game to spend some down rime playing., and at $XXX 
directly from Delta Tao, it's a bargain. 

Escape Veloctty: Nova 

Now, this game, From Ambrosia Software 
^ywvw.ambrosiasw.com), is a real winner. Nova is die third 
mstallment in the Escape Velocity series, and the first to run on 
OS X. This is a kind of hybrid game. Hiere are elements of 


strategy, combat, and story telling in the game. It doesn’t fall too 
much into any one genre. You play this game as one person try 
to make your way in the galaxy. You can trade good, ferry 
passengers, lie come a pirate, any number of different tilings. 
Tliere are also story line laced ihroughoui Uie world you will 
visit. Take one of diem one, and you get to improve your lot 
while doing some good deed (or not so gcxid, as the case may 
be) for the other denizens of this place. Improving your lot 
mainly means getting a bigger and better ship to move around 
the game in, Better weapons, faster drives, more luel, that sort of 
thing. There are so many little details that make this game really 
fun, tliai they just can't be listed here. 



Escape Velocity: Nova is SXXX, directly from Ambrosia. But, 
it doesn’l end there. The architecture of the game allow^s for 
plug-ins to expand and enhance the fun. In fact, Ambrosia re- 
released the original Escapee Velocity, and EV: Override as plug¬ 
ins for Nova, so now^ you can go back, and play tliose earlier 
games, and lose even more time to this fun. 

Game Over 

Don’t just limit yourself to these tw^o offering from these 
developers. Each has odier games, and even useful utilides, to check 
out. You may find tliiu one game, or, dare I say it, tool you need, or 
you know^ someone else on your gift giving list can't Eve without. 
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MAC OS X PANTHER 


ALL YOU NEED TO KNOW ABOUT PANTHER 


Want to know whaVs 
new in Panther? Turn 


to the one book with 


aii the answers. 


Sams Teach Yourself 
Mac OS X Panther 
All In One 

by Robyn Ness and 
John Ray 

ISBN: 0-672-32603-5 
$29.99 US 




Mac OS X 
^liMoyje&iDVD 
■Tunes & iPhoto 
Internet 
Mac Harilware 


Yourseif 


Mac OS X 
Panther 


One BdoA... 4Jr the Answers 




Sams Teach Yourself Mac OS X Panther 
Alt in One is designed to teach, in one 
book, the Mac user how to easily work 
with the hardware, the operating system, 
and key applications. Rather than focusing 
on a single product, the book covers 
multiple products and technologies 
together in a logical fashion. 

Topics Include: 

• Understanding the Mac OS X Panther 
interface. 

• Burning CDs and DVDs with iDVD. 

• Playing and organizing MP3s and 
digital music with iTunes. 

■ Digital photography with iPhoto. 

■ Editing digital video with iMovie. 


Visit www.amazon.com/samsbooks to download an overview 
of Panther’s new security features 


OTHER GREAT SAMS BOOKS ON PANTHER 



iUfe in a Snap 

by Jinger Simon 
ISBN: 0-672-32577-2 ■ $19.99 

Available Dec 2003 


an^on.com' 



Mac OS X Panther in a Snap 

by Brian Tiemann 
ISBN: 0-672-32612-4 • $19.99 US 

Available Dec 2003 


I 

- .imuiroNA |VfAur#f 

Mac OS X 
Panther 

! UNl.t,\.SMED 


Mac OS X Panther 
Unleashed 

by John Ray and William Ray 
ISBN; 0-672-32604-3 ■ $49.99 US 

Available Jan 2004 


sAms vwwv.samspublishing.com 


Amazon.com is the registered trademark ofAmazon.com. Inc, 
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Wear 


Look cool while giving all the great 
geek gifts 

Creeks love Hawaiian shirts. 1 know, 1 know, you're looking 
for electronics in this guide, but Fve gotta say that in my 
experience, geeks tove funky shirts. And why not close out 
MacTech's 2003 Cxift Guide for Geeks with something a little 
different than what you'd expect to find here. There are many 
vendors online that can accommodate wide range of prices and 
styles, from tasteful to tacky. 

Believe it or not there are a few rules to aloha shirts. 1 hese 
are generally ignored by tiiost, but some devout aloha shin 
collectors head straigla for the pocket and the l)uttons like a 
wane taster checking the cork. The pocket should match the 
background pattern. It should blend in so you can't see the 
pocket is even there from a distance. The Ixittons should fie 
made of coconut. That about covers the basic reciuirenients for 
the snooty shirt c£)llector. 

There are many great places to pick up shirts on tlie web 
and at a variety of prices. 



Reyn's (www.reyns.com) is one of the more sialwan shirt 
ctmipanies out there. They produce over a hundred original 
designs every year so you slioLEld surely be able find something 
nice at their site. Their shirts averagely priced at about $50-80 
depending on the shirt. 



If you’re slioppiiig witli a tighter budget then you might try 
Lots of Alolia (www.lotsofaloha.com) which has many shirt designs 
for $17.89-30.00. 



A site with a veiy large catalog of aloha apparel is Paradise 
on a Hanger (Www.hotshirts.com). They have shirts from as little as 
$20 all die way up to $250 premium, limited edition designs. 

You can even get some over at larger where we bought most 
of our lackySliirt w^ardrobe. Lhey tend to be seasonal items, 
liowever, and Decemlx^r is just alxiut as far out of season as it gets. 
If you try' tliere, you are likely to find pretty slim pickings. 

Typically, I'm against giving clothes for Cliristmas. You never 
get die right thing, it's always the wrong size, on and on. 
However, if it's something with character, dien that's a different 
story. Scxks are just socks, l)Lit a day-glow^, button-down sliirt 
covered with palm trees and hula girls will put everybody around 
you in a good mood. Just make sure you can get it in XXL, which 
is die typical size for most of die geeks I know. Oh, and I'm 
partial to red and black if youVe buying for me. 
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[Thinkfree]J 


ThirikfreeOffice 

COMPATIBLE WITH MICROSOFT WORD, EXCEL AND POWERPOINT 
WORDPROCESSOR • SPREADSHEET • PRESENTATION GRAPHICS 

The Affordable Office Alternative! 



Macworld 

I f I 


Thlnidree is s 
best-of-breed pragraim 
iiiat will exceed your 
Expectetjons." 

— J&ffsry Batt^rsty 


RATED 


ooooo 

GREAT 


“Tbinktree Office is the 
next best thing and 
then some,’* 

— Deborah Sh^dovfiz 


^Thinkfinee Office is an 
irnpcessive attempt to 
crack the seemingly 
impenetrable 
productivity market." 

— Chris Ward 
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I'M eUECTROnKTS 


Three High-Performance Applications 


Thinkfree Write 

Thinkfree Write is a powerful word processing application 
thot enables you to create rich, professional quality 
documents and Web pages. You can insert tables, 
images, and clipart, or even apply custom layouts to 
your document.*.then effortlessly proofread your work 
with the easy-to-use spelling and auto-correction features. 

Thinkfree Calc 

Thinkfree Cate is a full-featured, easy-to-use spreodsheet 
application that can easily tackle the most complex 
analytical tasks with over 40 charts and 300 function 
capabilities. Thinkfree Calc opens, edits, and saves 
directly into the Microsoft Excel (.xls) format, so users 
con seamlessly share documents and collaborate with 
Microsoft Office users. 

Thinkfree Show 

Thinkfree Show enables you to create high-impact 
presentations including animation effects, drawings, 
images, clipart, and other graphic features. Thinkfree 
Show opens, edits and saves directly into the Microsoft 
PowerPoint (*ppt) format* 

CyberdrivePlus 

A free, one-year subscription to CyberdrivePlus is also 
included. CyberdrivePlus provides you with secure, 

Internet file storage and free online software upgradesl 


ONLY 






t * t M Elia 


niinkFr^ and Thinkfree Office ore fradamorks oF Thinkfree Corporertion. AIJ ohher trademorks orid/or registered Imademorks ore properties of their respective owners. 



































































SOFTWARE 

MARKETING 


By Daw Wooldridge 

Turn Your Web Site into a Marketing Machine 


Web Page Essentials for Promoting 
Your Software 

Last iTKMith, we kicked off this series with a c|uk'k 
overview on the importance for shareware and commercial 
developers to see the '‘big picture" when planning a new 
product. All of the decisions you make during the 
development phase directly affect the marketing and lifespan 
of your product. Establishing a brand identity and positive 
first impressions for your software are just two t>f the many 
crucial elements needed for a successful product line. 
Another valuable element that was briefly discussed was the 
presence of a professional web site for your software 
company. This nK>ruh, we ll explore .several marketing tools 
and techniques that you can integrate into your web site to 
help increase awareness and sales for your software. 

Pitfalls To Avoid 

Firsts let’s review what should NOT be included on your 
soflw^are web .site. Photo galleries of your favorite 
supernifKlel.s, dissertations on why Wolverine is the best X- 
Men character, a web shrine dedicated to U2, and digital 
pictures of your family trip to Hawaii are just a few exampies. 
These are all highly acceptable forms of self-expression, but 
by posting them on the same site as your software, youVe just 
slapped a huge scarlet letter “A" For "amateur’' on your virtual 
.software company. To some of you, this may seem incredibly 
obvious, but many sharew'are developers listed on 
VersionTracker.com continue to make the mistake of 
including personal interests on their sites. 

To blog or not to blog... While blogging has become one 
of the Internet’s hottest new trends, the very nature of its 
diary-like \soapbox" can lead to negative reader reactions. 
And if a potential customer does not agree with your world 
viewpoint, they may react by choosing not to Imy your 
products. So should your blog reside on your software web 


site? It depends on how' you use it. If you utilize the web blog 
to inform users on the development status of a particular 
software project, then blogging may work to your advantage 
in establishing a close relationship with your customers. But 
if you post opinionated entries about religion, politics, or 
even something as innocuous as the software industry', then 
you run a good chance of offending someone out there and 
losing a potential sale. 

Eleven Web Site Essentials 

Last month, several marketing concept w^ere illustrated 
through the creation of a fictional .software product named 
CodeQuiver. Figure 1 show's a mock web page for 
CodeQuiver with numbered arrow.s pointing to each one of the 
eleven web site essentials. You’ll w'ant your web site’.s interface 
to have ifs own unique design, but hopefully, this template 
w'ill serve as a helpful guide wlien deciding which components 
and features to include. 

1 - Intuitive She Navigation 

Building an easy-to-use menu system for your site will 
allow your visitors to travel freely through your pages without 
getting lost. Placing a global menu on every page of your site 
prevents the need to backtrack to the home page just to visit 
another section. A user's online experience at your web site 
should be as painless as possible. If people become frustrated 
or impatient while exploring your site, their negative mindset 
may taint their first impression of your software. To keep 
things running smoothly, maintain a simple and intuitive 
design. CocleQuiver's site navigation (Figure 1, Item 1) is a 
very basic tabbed menu. Visitors always know where they are 
since their current location is marked by a highlighted, yellow 
lab. Visitors also have access to any other section of the site 
via the gray tabs. 


Dave Wooldridge is tlie founder of Electric Butterfly (vvww.efautterfly.corn), tlie web design and software company respoasible for Stimulus, HelpLogic, 
UniHelp, and tlie popular developer site, RBGarage.com, 
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Figure L A Jiciiunai weh page for CodeQuiifer Hems J-11 
refyresenl a bemd/ld ofessenlial eiemenfs that can beip you turn 
your softwcire company site into a marketing machine. 


Another advantage to a gUybal site menu is to encourage 
impulse purchases of your other software titles. A consumer 
may have come to your site to buy a specific product, but w ith 
your other prcxlucts only a single mouse-click away, that 
person may decide to take a quick look. And if some of your 
customers walk away with twc^ or three purchases when they 
only came to buy one, your site navigaticm has proven itself io 
be quite effective. 

For those of you who feel artistically-challenged, the 
design of your site interface does not need to be complex or 
intricate. In Figure 1, the most complicated image on the 
page is the produci logo, The rest of the page uses very little 
imagery, Some of the most attractive softw'are pages 


available online are those that appear simple, clean, and 
most importantly, easy to read. Just look at Apple.corn's 
minimalist design. Its white, uncluttered pages appear very 
elegant and professional. 

If your site currently includes hundreds of web pages, a 
'Tirilhdown'' menu approach to your site hierarchy may still not 
provide convenient direct access to important pages. For large 
sites, many developers contemplate the use of a site-wide search 
engine. Depending on what scripting languages your web server 
supyxjrts, there are dozens of freeware and sharew^are options 
available online for Feii PUP, ASP, JSP, etc. 



Figure 2. You can add free, customized Google SiteSearch to 
your web site m only a matter of minutes. 

If your web hosting account does nor currently support 
CGI or server-side scripts or if you have very little experience 
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coding wch-based scripting languages, then you may want to 
check out Google’s free SiteSearch service at 
http://www.google.com/searchcode.htnnl 

With only a few lines of HTML code that can be easily 
pasted into your web pages, Google provides you with a free 
turn-key site search solution that can be up and running in a 
matter of minutes. 

For the ultimate in customization, you can also sign up for 
the next level in Google's free SiteSearcli service, enabling you 
to tailor Google's search results page with your own company 
logo and site colors. To see an example pop-up window of a 
customized search results page, see Figure 2. To sign up for 
this advanced free SiteSearch service, visit 
http://www.google.com/services/free.html 

2 - Product Brand Identity 

Last month, we covered the importance of establishing a 
brand identity for your software product - a unique logo or 
image that is consistently displayed across all visual elements 
such as your web site, banner ads, print advertising, your 
application's icon and “Abcmt" window, etc. Repeat viewings of 
this key imagery will help foster consumer recognition, so on 
every web page related to your application, include your 
product logo or signature imagery. The logo placement of 
(k)deQuiver in Figure 1, Item 2, is just one of many ways your 
software can be represented on your site. 

3 " Purchase and Download Links 

While developers are already aware of the necessity of 
including purchase and download links on their software 
web pages, it should be noted that the placement of the.se 
two items is critical. Newspaper editors refer to the most 
valuable real estate as the top half of the page above the 
fold. To see below the fold forces the reader to flip over ihe 
newspaper, which requires a second step. The average 
consumer is too busy to waste time looking for the.se links. 
If you place these two links at the bottom of your web page 
after your product description, you run the risk that the user 
may not bother to scroll dowm beyond the initial screen 
(below the fold). Alsu, do not bury^ these two links within 
your product description. As silly as it may sound, many 
consumers scan through sites so quickly that they may not 
see the links unless they are placed at the top of the page 
with eye-catching buttons or large bolded text. We used to 
receive a few c-mails every month from visitors looking for 
a certain download link that was there on our site, but they 
just could not “see” it. We moved the link to the top of the 
page and replaced it with a large button, and now we no 
longer receive those kinds of e-mail queries. If they can't 
find it, they can’t buy it. Figure 1, Item 3 shows how the 
download and purchase buttons are prominently displayed 
on the w^eb page, strategically ’‘framing” the text description 
in the center. 


4 - Text vs. Graphics 

When it comes to listing the current version number, 
price, and other key elements, there are two advantages to 
displaying this information as plain HTML text and not as 
graphic images. One is that search engine bots only read text 
when indexing your site, so it’s important that they pick up 
the appropriate keywords in your web page text for higher 
search rankings. Secondly, HTML text is a lot easier and 
quicker to update than having to edit and resave an image 
hie. Many developers include the version number next to the 
product name in the software logo image. Sure it looks 
stylish, but it takes that much more time to modify the 
graphic the next time you release a new version. With the 
frequency that version numbers, prices, and product 
descriptions change, an effective web site is not only one 
that best serves your audience, but also one that best serves 
your busy schedule. Time equals money, so we’d ail rather 
be programming the next killer app and spending less time 
updating web pages. 

5 * Product DEscRimoNs 

When was tlie la.st time you read a lengthy product 
description online in its entirety? Reading Long paragraphs of 
text in a web brow'ser is not only hard on the eyes, but it just 
feels tedious. Most people don’t take the time to read online, 
'fheir eyes dart across the screen, looking for keywords and 
phrases that can quickly summarize whai your software 
product can do to make their life better. And ytju re lucky if 
your web page receives fifteen seconds to convince them of 
that before they move on to the next link. We live in an age 
where essays have seemingly been replaced with PowerPoint 
decks and bulleted lists. 

Brevity is key. When it comes to editing your product 
description for the W'eb, less is more. Be carehil to include all of 
the necessary keywords to improve your placement in the 
search engines, w^hile whittling down the description to short 
paragraphs and bullet points. Rmphasize the key features that 
will attract buyers. Save the minutiae for your documentation 
and help file. 

if your software is a complicated application (such as a 
development environment) with lots of features that need to 
be mentioned, it s a good idea to break the different sections 
of your description into several interlinked pages. This way, 
consumers get a lirief overview' from reading the main 
product page and those who are interested in learning more 
can click on links to view^ detailed explanations of features, 
specifications, etc. This modular, “drill-down” approach 
provides the information in bite-sizx*d, ea.sy-to-digest servings. 
A side benefit Co splitting long de.scriptions into multiple, 
mierlinked pages is that there are now more pages that can 
be indexed by search engine bots for ranking placement. Just 
be careful to maintain a safe balance between sectioned 
pages and convenience. In Figure 1, Item 5, CodeQuiver’.s 


58 


Turn Your Web Site into a Marketing Machine 


MacTech • Nowaiber 2003 





main description is very brief with related links listed in the 
right column. Most of those links only go one level deep. 
While you want your pages to be read, you don't want to 
create too many sublevels of information, making specific 
details hard to find. 

6 - Screenshots vs. Features Toltr 

First of all, if you don’t already include screenshots on 
your site, then you’re missing out on a valuable selling tool. 
For software with a user interface, people want to see what it 
looks like. For those who are lazy enough to say that people 
should just download and try the software if they want to see 
the interface obviously don't remember that people are lazy 
enough to walk away rather than take the time to download an 
unknown application. If someone is seriously interested in 
your product, they will download the trial version immediately, 
hut many of your site visitors may only be casually browsing. 
Those are the impulse buyers that you want to hook with 
enticing screenshots. 

Many developers simply post a web page of five or six 
screenshots with nothing more than one or two word 
captions like ‘'Main Window" or ‘‘Preferences Window.” While 
this does serve the puq^jose at hand, there is a more elTeciive 
way to turn mild curiosity into serious interest. In the last 
section, we discussed the need to keep product descriptions 
brief and now^ we see tlie need to add more descriptive 
context to screenshots so that consumers truly understand 
what they are viewing. You cari kill twf} birds with one stone 
by creating an online Tour" of your application. This concept 
usually consists of several pages linked in succession with 
‘‘Previous” and “Nexr arrow buttons, so that a consumer can 
travel effortlessly through the tour, learning more about your 
product with each new step. In Figufc 1, Item 6, the 
“Features Tour" link would take a reader through 
CodeQuiver’s key features such as adding a code snippet to 
the database, searching by keyw^ord for specific code 
snippets, showing CodeQuiver’s compact interface working 
side-by-side with Apple's Project Builder, etc. Each page 
would include one or two screenshots with a paragraph that 
explains the illustrated feature. 

7 - Testimonials, Awards and Reviews 

It may feel awkward to brag about your own creations and 
achievements, but that’s one of the job requirements wdien 
selling your softw^are. People want to know about awards and 
stellar reviews. I'hey want to read comments from their peers. 
These accolades are important because they establish 
credibility for your softw^are. Your web site needs to be an 
effective advertisement for your products, serving as an 
interactive marketing brochure to help consumers with their 
buying decision. 

If yoirre shopping for a new text editor and youYe trying to 
decide between the 4-star, award-winning veteran and a cheaper 
unknown brand, you're probably going to choose the acclaimed, 
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popular one. Even though it’s more expensive than the others, 
it’s fairly easy to justify the higher price if that text editor is 
perceived as a higher quality product. 

You need to argue that same case with your software 
products. If your software has received positive review^s and 
awards, let your site visitors know about ihem, It can mean 
the difference between their purchase of your product or 
your competition’s. Did Tucows.com aw^ard your product 
with a 5-cow rating? Did VersionTracker.com users 
collectively rate your product with a 4.5-star average? Never 
assume that site visitors are already aware of these accolades. 
Figure 1, Item 7 shows an example of a key quote from a 
leading developer magazine placed prominently on 
CodeQuiver’s web page. If an expert's opinion piques 
someone’s interest enough to read more and even download 
the trial version, then the ‘'hook" worked. 

Make sure your bragging rigJits are earned and not self- 
prcxlaimed. Announcing on your site that your own product is 
the “best in the world” does not educate consumers “ it simply 
comes off as arrogant. Bui if a leading [nagazine awards your 
product as “best choice*^ in its category, then that is a badge your 
site can proudly display. 

If your prcxluct is brand ne%v and has not yet had tlie 
opportunity to garner any acclaim, then posting a dedicated 
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page for customer testimonials and reviews may be a tad 
premature. Instead, ask fellow^ developers to beta test a pre¬ 
release of your software. If they have positive feedback, then ask 
for their permission to post their kind words online. A few solid 
recommendations quoted on your site can really help sell an 
otherwise unknown product. 

But word to tine wise, do not fabricate ratings, awards or 
testimonials. People are smarter than you think and can usually 
smell a rat, VersionTracker.com users are veiy^ adept at spotting 
fraudulent feedback, so df? niyi pose as an anonymous 
VersionTracker member waxing poetic on how cool your own 
software is and why it deserves 5-slars. If suspected, they w ill 
pin you to the mat with flaming feedback postings, accusing you 
of being an unethical amateur - exactly what we’re trying to 
avoid. We want to attract new customers, not drive them away 
by the truckload,s. 

8 - Onijne Support 

One of the key elements that factor into a consumer’s 
buying decision is the level of support that comes with a 
software purcha,sc. Consumers look to your web site as an 
indication of how you support your products. If your online 
support consists only of a single e-mail link, then you may 
not be providing the level of comfort that a potential 
customer is expecting. Telling cusKrmens to e-mail support 
questions to dave@codequiver,com - wliich is the same e-mail 
a d d ress 1 i sted ioT s a I e,s i n c | u i r i es - m a kes you r com pa n y look 
like a small operation. If c{)nsumers suspect that the same 
person that develops the software is also swamped 
answering all .sales and support e-matls, they may fear that 
iheir support question will go unan.swered for days. While 
this may be an unfair perceplion since many shareware 
developers successfully run their nwm one-person businesses 
and provide better support than most Fortune 500 
companies, it is a common misconception that your web site 
can help alleviate. 

For shareware products, consumers generally do not 
expect toll-free support phone numbers, hut they do expect 
to find online supp{>rt forms that allow them to submit details 
of their problems. There are dozens of freeware “form mair 
CGI scripts available online that can he implemented to send 
web-based form data to your e-mail address. Most web 
hosting providers include a form mail script for their 
accounts that is already configured to work with their 
servers. Not only do online forms add a professional polish 
to your site, t>ut they also prevent spam bots from harvesting 
a listed e-mail address. Tech support is busy enough as it is 
answering customer queries without having to wade through 
an endless sea of spam. 

Your software web site shot] Id not only help you make 
money, but it should also help you save money. Tired of 
receiving support and sales e-mails with common questions that 
youVe answ'ered a million times? Take a moment to add a web 
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page for frequently asked questions (FAQ) or a searchable 
online knowledgebase (see Fig;ure 1, Item 8). 

Do not rely solely on an Apple Help manual that is 
accessed from within your software application. If a customer 
cannot launch your application, then they may not know' how 
to manually find and open its Apple Help files. Instead, tliey 
will turn to your web site for assistance. Since Apple Help 
consists of HTML files, it should he relatively easy to add 
these pages to the support section of your w’^eb site wdth 
minimal tweaking. 

The extra couple hours it takes to add the additional 
documentation and support pages w ill save you countless hours 
in the future with fewer suppcjit e-mails to answer. Not only will 
the presence of these extra pages instill conifoit for those 
consumers who are evaluating yt^ur software and support 
services, but these web pages will allow your global customers 
in various time 2 :ones to find quick solutions 24 hours a day, 7 
days a w'eek - even when youTe asleep. 



Fetch 


9 - The Art of Upsfxijng 

Some of your best customers will be ones that have already 
purchased one or more of your products. Reward their loyalty^ 
with special upgrade offers (see Figure 1, Item 9) and exclusive 
discounts on new prcxlucts. Since your satisfied customers are 
already aware of your development quality, selling them new 
products does not require as much effort. Be careful not to 
exploit their loyalty with excessive upgrade fees. These are the 
people who praise and recommend your software to their 
friends, family, and co-w'orkers, so they should l>e appreciated 
and rew'arded accordingly. Well dive deei>er into the art of 
up.selling in a future issue. 


10 - E-fviAiL Newsletters 

Even though you alwrays post the latest news and release 
information online, consumers may not remember to revisit 
your site for new updates. If they're interested in your 
software, don't throw aw^ay the opportunity to continue 
commimicating with them. By offering a free e-mail 
newsletter service (see Figure 1, Item 10), consumers can 
sign up to receive monthly software news and special offers 
from you via e-mail. This gives you a very powerful 
marketing tool for promoting your software directly to anyone 
who is interested* Since these site visitors voluntarily ‘’opt-in'' 
as new^sletter subscribers, you don’t have to worry about 
spam accusations. These subscribers wan! to receive e-mail 
from you (as long as you don't flood their e-mail box witli 
more than one or two messages a month). A proper e-mail 
newsletter service provides a "unsubscribe” link at the bottom 
of every' delivered message, so that subscribers always retain 
the ability to "opt-out” if desired. 

So how can you add this cool service to your w^eb site? 
Some web hosting providers offer list servers as an add-on 
option “ that’s one approach. Another common technique is to 
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use a web form that saves entries to a flat-file or SQL database. CGI 
scripts can then be engineered to send a bulk message to tfie e- 
mail addresses from that database using the seivef.s mail program, 
'fhe problem with tliis appniach is it creates a lot of extra work for 
you as the developer. You may not have to start from scratch as 
tliere are a lot of existing scripts available online for Perl, PldP, ASP, 
etc. Check out ScriptSearch.ajm and look under the “Mailing List 
Managers” category. Even if you do find a freeware or shareware 
set of scripts that suits your needs, you will still have to set-up and 
configure this web-based system to work w'ith your server. 

If that sounds like a royal headache, then there are third- 
party services that can offer you an automated solution (with 
many time-saving feamres) for a minimal fee, Microsoft's bCentral 
site offers a service called ListBuilder that will manage your 
newsletter mailing list. Sign up for an account at ListBuildencom, 
add a few' lines of code to your site, and youVe got yourself a full- 
featured e-imiil newsletter service widiiji minutes. You're given a 
wel?-based administration panel for customizing your ListBuilder 
account, sending new messages (as either text or HI^ML e-mails), 
and even importing/exporting e-mail addresses. Every newsletter 
sent through ytiur ListBuilder account includes a convenient 
“unsubscribe" link at the bottom of die e-mail, automating a task 
that would otherwise take you hours to develop or manually 
maintain yourself. Coasumers can subscrilx^ and uasubscrilx: 
witliout you having to lift a fmgen ListBuilder Ls not fme, hut ilie 
annual cost may be worth the time it saves you. 


11 - Tei.l-A-Frji-nd 

We've all seen the various "Tell -a-Friend" or "Email to a 
Eriend" links on various \veb sites. This "vimf marketing tool is 
a very pow^erful grass-rotas metlKxi of increa,sing aw'areness for 
your software products by enabling your site visitors to ‘‘spread 
the word,” And the ix:si part is that once this feature is sei-up on 
your site, you don’t have to do a tiling - your site vi.sitors are the 
ones doing all die work! If someone visits the CodeQuiver w^eb 
page and wants to tell a co-worker about it, that person can 
easily recommend the site by clicking on the “Email this Page" 
link (see Figure 1, Item 11). 

Clicking the “Email this Page" link passes the current web 
page's UKl and document title to the lell-A-Friend page as 
parameters. The TeJl-A-Friend page then dynamically displays a 
web form wnth the parameters stored as HTML form values (see 
Figure 3)- The user simply completes and submits the form to 
send the page recommendation to a friend. TliLs can all be 
scTipted quite easily in either JavaScript, PI IP, ASP, etc. with the 
final form being handled by a CGI fonn mail script (as discus,sed 
earlier in this article). Before you roll up your sleeves and lx?gin 
codings check out the "Site Recommendation” category on 
ScriptSearch.com under your favorite scripiing language and 
you’ll find a large collection of existing .solutions that you am 
customize for your ow n needs. 

While this “Tell-A-Friend" component is fairly eiisy to 
implement, there are some important factors to consider. Keep 
the web form brief Only include the required fields necessary to 


get the job done (see the example in Figure 3). If the form takes 
too long to fill out, people w^on't use it. Also, never record the e- 
mail addresses that are submitted tlirough the “Tell-A-Friend" 
script and state this promise on the “Tell-A-Friend” page with a 
link to your site's Privacy Policy (something that all sites should 
have in today's world of spam and privacy law^suits). If visitors 
are uncertain as to whether e-mail addresses are being recorded 
or not, tliey may avoid using the “Tell-A-Friend" feature. The 
word of mouth acliieved will prove to be much more valuable 
than the e-mail addresses you might be tempted to collect. 



Figure 3^ Adding a 'Tell-Ad^'ncfidfeature to ymir 
site enables visitors to easify "spread the word" 
ahoul }mir software products. 


Your Web Site Works for You 
As programmers, we understand how u.ser experience can 
make or break a sale. This should be a major concent not only 
when developing your .software, but also wJien designing your 
web site, ft serves as a tireless online sales and support 
representaiive, promoting your software and aiding your 
customers rouad-lhe-ck)ck. While the w^eb essentials discussed 
here are only a handful of po.ssible tools, hopefuDy you'll find 
some of these ideas helpful in turning your softw^are company's 
web site into a marketing machine! 
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Up and Running with the SSCLI 


Exploring .NET development on Mac OS X 


Let there be code 

In the last issue, you were introduced to a nunilier of 
specifications that qualify the .NET platform, collectively termed 
the Common kmguage [nfrastnicmre (CLI). As [iientioned, these 
specs (no matter how^ detaiJed) do us little good until they are 
implemented in a usable code base. In this installment, you will 
obtain, configure and explore one such implementatit>n of the 
CLI named the Shared Source CLI (SSCIi). Although iJie SSCLI 
originates from Microsoft Corporation, the contained source 
code is designed to build on Win32, Mac OS X and tilher 
FreeBSD“based distributions. 

THE Role of the Shared Source CU (SSCLI) 

Before w^e can begin creating our own custom .NKV 
(see previous issue) our first task is to obtain a viable 
implementation of the CLI. For the time being w'e wall 
concentrate on a revSearch-ftxTised distribution ]:)rovided by 
Microsoft named the SSCLI (w^hich also is referred to by its code 
name Rotor). The SSCLI is Te.search-focused' in that it is not 
intended to he u.sed to as a production level development 
platform (though on some levels, it most certainly could be), but 
rather as a tool to explore the programming language and the 
technologies defined by the CLI iLselL 

The SSCLI does not ship with an implementation of 
ADO.NET (.NETS data access API), ASRNET (.NET'S Web 
development API) or Windows Forms (.NET’S GUI desktop 
API). On the plus side, the SSCLI does supply a fully 
functionality compiler, a JScnpt.NET compiler (which is, 
in fact, written using C^), a VE8 implementation and core 
class libraries (descnhed a bit later in this article). As you 
w^ould also expect, the SSCLI ships with a number of 
command line utilities (security tools, compilers, assembly- 
tweaking tools and so forth) that allow' you to interact with 
the piatform itself. 


The source code contained within the SSCLI is a blend of 
C++, and assembler mstruaions (used for only die very 
lowest of low-level OS-specific details). A majority of the C++ 
code represents a key aspect of die SSCLI termed the Platform 
Adaptation Layer (PAL), wJiich abstmcLs away OS-specific details 
(more details in just a moment). On a related note, the C++ 
programming language is used to build the compiler. Beyond 
this however, makes up a majririly of the .scjurce code, which 
is used to implement a vast majority of the SSCLI base class 
libraries as w'ell as the JScripl.NET compiler. 

Rest assured that by taking the lime to work with the SSCLI, 
you will not only gain a solid understanding of the C# 
programming language, but core a.spects of the .NET runtime 
engine and the programming tools you will make use of on a 
daily basis. As you would guess, this will provide an excellent 
foundation when examining otlier implementations of the CU 
.such as Portable .NE1', Mono and Microsoft's CLR. 

Defining ‘Shared Source' 

Tlie ‘SS’ in SSCLJ refers to the iact that the code base may 
extended, modified, hacked, compiled and shared iunong 
developers. Thus, if you wish to add additional ftmctionality to 
the C# compiler, change the w'ay the execution engine handles 
memory allocations or use tlie code representing the JScript.NET 
compiler as the basis for a new .NET language compiler 
(Logo.NET anyone?), you may do so! However, what you may 
not do is redistribute a modified SSCU code base for monetary 
profit (after all, shared saiitre is not quite open source). 

Throughout this series, it is my assumption is tliat most of 
you are more interested in using the SSCU as a vehicle to 
understand the .NET platform and C# language rather than to 
alter die existing code !>ase. Given diis, I do not intend to spend 
too much time drilling into tlie low-level SSCLI implementadon 
code, unless it provides insights into die discussion at hand 
(whatever that may he). Ilow^ever ii' you do intend to tweak and 
recompile the SSCLI source code files, he sure to read tlie (one- 
page) license agreement (license.txt) located under the root /ssdi 
folder. Here you will find more details regarding the shared 
source mindset. 


Andrew Troelsen is a seast>ned .NET developer w^ho has authored numerous books on the topic, including the award winning O and the .NKf 
Platform. He is employed as a full-time .NET trainer and cx:>n.sultant For Intertech Learning (WWW. intertechlearning,com) and spends his idle moments at 
home playing far too many video games. You can coniaci Andrew at atroelsenOmac.Com, 
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Yom Friend, the PAL 

As men[ioned, a major chunk of C++ source code 
represents the Platform Adaptation Layer, or PAL. The role of 
the PAL is to emulate a subset of the Win32 APIs for use on 
diverse operating systems. The operative word in that last 
sentence is subset. Basically, the PAL is a platform neutral API 
which exposes core services such as file 10. networking 
services, error handling, threading and so forth. The trick 
however is that although the names of these functions map 
directly to Win32 APIs, their implementation will differ wildly 
based on the underlying target operating system. 

The next ix)int to be made regarding the PAL is die fact that 
the /sscli/pal folder contains two subdirectories: unix and Win32. 
As you would guess, if the SSCU were built on a Win32-based 
machine, the code within the w^in32 folder is used to build die PAL. 
Under Unix-lxised systems (which of course includes Mac OS X's 
Darwin), tlie unix folder is consulted during the compilation 
process, in either case, it Ls worth menrlonlng that not all of the 
functiotis defined by die PAL liave an exact match in the Win32 API. 
To be sure, there are a small number of functioas (all of wliich have 
the TALJ prefix), which are particular to die SSCli itself. 

Again, if you don’t Intend to modify the SSCLI or port die code 
base to a new operating system, you am basically be blissfulJy 
unaw^are of the gory details regarding the Platform Adaptation 
Layer. However, if you wish to take a detailed look at tlie 
functions defined by the PAL, you can read die “PAL guide"’ which 
is doaimented in /sscli/doc's/techinfo/pal^jide.htrnl. If you wish 
to view^ the ex::ta C++ header file that prototypes each function 
(and the related C++ stmctures, enumemtions and typedefs), 
examine the rotor_pal.h file located under tlie /sscii/p^it folden 

Downloading the SSCLI 

To obtain die SSCU, launcfi your Web browser of choice 
(Safari, of course) and navigate to http://msdn.microsoft.com/net/ssdi. 
Scroll dowTi to tlic end of this page and dow^nload die files ILsted in 
Tabk 1 to your folder of choice. Be very aware tliai die SSCLI will 
not build if the local directory padi contains any spaces. Therefore 
a subfolder in your Developer folder named “My_DotNet_StufU is 
fine, w'hile “My Dot Net Stuff’ is quite problemadc as far as the build 


process is concerned (diis is true of IJnLx builds in general). 

File to Download 

Meaning In life 

sscli_20021101.lgz 

ThLs file contains the code needed to build a 
w orking implementiilion of die CU, including 
md JScript.NET compilers. 

ssdi_ref_20021101.tgz 

This file extracts to an HTML based class 
libraiy browser that dfxiumenLs all of the types 
supplied by the SSCLI. 


TahieL The file of the SSCU 


As you will surly notice, the size of these files are quite 
large. Again, given that the SSCLI is a research-focused 
implementation of the CLI, you wall be downloading a huge 
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amount of raw source code. Later in this series when we shift 
away frcjm the SSCLI to a 'real-world' implementation of die CLl 
(such as Portable ,NET) you will be pleased to find more 
manageable downloads. 

Obtaining and Installing Tcl/Tk 
Before you unpack and build the SSCLI, you will also want 
to make sure that your Macintosh development machine is 
equipped with Tcl/Tk. First two questions: “What is Tcl/Tk and 
why do I need il^" Tcl/Tk is a GLIl toolkit and scripting language 
that can be used to build traditional desktop applications. As 
mentioned, the SSCLI doe.s not ship widi an implementation of 
Windows Forms, however several sample applications make use 
of the Tk 8.4.0 widget set to illustrate how the SSCLI can be 
extended to support alternative GUI tcxilkits. Therefore, if you 
wish to run the supplied Tcl/Tk samples (which w^e will do at a 
later time), you will need to install this Unix package. 

Next question: “Wliere do 1 obtain Tcl/Tk?” www. 5 criptiG.Com is 
tile official web site for Tcl/lTc, and fR>m here you can download the 
latest binaries. If you prefer a Mac-friendly alternative however, you 
am make use of Fink tand^or Fink Ojmmander) to download and 
iastall Tcl/Tk with minimal fass and bother. 

This leads me to address tJie Rnal piissible question you might 
have at this |X)int: ''Whdi is Fink?" (if you alretidy know the answer, 
feel free to begin your download now). Given that ilte Mac OS is 
a Unix-based operating system, the Fink project was created to 
provide a simple way to install Unix software on tlic Macintosh. 
While Fink is a conimaad line driven loo], the complementaiy^ Fink 
Commander application provides a GUT shell to tlic same 
functionality (lx)th can be downloaded from 
http://fink. 50 urceforge.net). Assuming you have Fink Commander up 
and running, simply do a search forTcl (Figure 1) and insuil) the 
tcltk binary using tlie Binary | ln.stall menu option. 

'# 0 IB _ 10 DtijNiiM- _O* 

7.13.1 TO IMril twmt 

13.1-] dAriMc TCi 
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figure L Obtaining Tcl/Tk via Fink Commander 

Once you have installed this package, you will find 
Iibtcl8.4.dylib and libtk8.4.dylib lil^ntries have been installed (by 
default) under your /sw/lib folder. 

Bltlding the SSCLI 

Due to the fact that you are reading MacTech, you are no 
doubt a software developer (hobbyist or otherwise), and given 
this fact, rd bet you have latest and greatest Mac OS 


programming environment. Nevertheless, do know that tlie SSCIi 
expects the following minimal softw^are/hardware requirements: 

• Mac OS X version 10.2 or higher. 

• The Apple Developer Tools. 

• The BSD subsystem installed (this is done by default when 
installing OS X). 

• 256 MB memory' at minimum, 512 MB (recommended), 1 GB 
(the best!). 

• One gigabyte of free disk space (remember...this is a 
research distribution). 

Building the SSCLI is very straightforward and only involves 
interacting with two files: env.csh and buildall. Env.csh is a 
Unix-based shell script that defines a number of platform- 
specific enviroomeni vuriabies required by the SSCLL The 
buildall file, as you would expect, is a script that drives the build 
process for each of the contained subdirectories. This being 
said, perfonn the following steps to build the SSCLI on your 
development machine: 

• Extract ssc]i_20021101.tg2 (either Stufflt or the gnutar utility 
will do)* 

• Open a Terminal and navigate to the sscli directory. 

• Source the env.csh file at the command line (e.g., type: 
source env.csh)* 

• Finally, Iniild the SSCLI by ty ping ./buildall (within the same 
Terminal ses,sion). 

At diis point, the build prcKess begins and will continue for 
some lime (now would be a gcKjd time to catch up on your e- 
mails or other such ToDos). If you are interested in examining 
further details of the build process, check out the 
building_sscli.html, env.html and buiidall.html documents 
kxated under sscli/docs/buildtools/. in any case, once the build 
process is complete, your Macintosh development machine is 
ready to plunge into tlie .NET universe. 

Learning the Lay of the Land 
Next up, let's lake a moment to examine the generated 
directory structure* Using the Finder, open up the root 
directory of your SSCLI installation. To be sure, the 
installation process generates an elaborate directory 
structure, however Table 2 describes some of the key folders 
to be mindful of* 


SSCLI Subfolder 

Meaning In life 

/build/vl .ppcfstchk, rotor 

This Ls the root folder that 
contains the compiled tools 
and various SSCLI class 

libraries. 


/buiid/vl.ppcfstchk.rotor/assembly/GAC The location of the Global 
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Assembly Cache (GAC) that 
contains a number of sharecF 
assemblies. As seen in a later 
article, a single copy of a 
shared assembly can be 
consumed by multiple NET 
client applications. 


./biiild/v 1 ppcfstchk.rotcr/cDnfig 

Contains various XML-based 
SSCLI configuraiitjn files. 

/clr/s rc/bcl/sy stem 

Contains the C# .source ct^de 

files for the base class libraries. 

./clr/src/cshaq:} 

Contains die C++ source code 

./clr/src/iiasm 

for the C# compiler (esc), Cll 

/clr/src/ildasni 

compiler (ilasm) and CIL 

/clr/src/fiLSjon 

dissas.sembler (ilda.sm). The 

fusion .subfolder contains code 

lliat allows the SSCLI to bind to 
specific version of a .NET 
assembly (more details later). 

/dcics 

You guessed It, here are a 
number of HTML based 

dcK:ii mentation files for the C# 
compiler, SSCLI development 
tools and the underlying 
infrastructure. The index.html 
file (located in /docs) is the 
home page' for all other 
docLimenLUion. 

/fscripl 

source code for the 
JScript.NET compiler. 

/pcil 

C++ source code for the 
Platform Adaptation Layer (PAL). 

/samples 

Various sample programs to 
build, modify and execute 
within the SSCLI. 

/tests 

Numerous source code files 
that can lie used to test a 
modified SSCli distributi<m. 

/tools 

These are tools used during 
die build process of die SSCLL 
not tools for building SSCli 
applications! 


Table 2. A partial li'^ting of/ssdi subdirectories 


A few pages ago, you were introduced to tlie role of the 
/pal folder, i would also lil<e to encourage you to check out the 
/samples folder Here you will find numerous C# sample 
applications that illustrate programming with the SSCU base 
class libraries (/sscli/samples/.samplesjndex.htmi provides 
details regarding each sample application). 

The next folder to be aware of at this point is the all- 
important /docs folder and the index.htm file it contains. When 
you open this file, you will find an exhaustive list of all of the 
documentation files for this CLI distribution, I highly 
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recommend you save this file to your browser's Favorites list, as 
you w'ill come here time and time again to learn about the tools, 
samples and technologies provided by the SSCLI* 

Lnstauing the SSCll Onune Documentation 
The next configuration task is to extract the SSCU online help 
contained within sscli_ref_20021101.tgz. Once you have extracted 
this binary (again, either Stuffit or gnutar will do), you will find a 
file named ClassLibrary.html within the root directory. As you 
would guess, this file ctmtains links to each of the namespaces of 
die SSCli, the highlights of which can be seen in Table 3. 


Navigating the HTML-based help system is simple. To take 
things out for a test drive, click on the System.Xml link located 
towards the bottom of ClassLibrary.html. Once you do, you will 
find a ‘home page' for the .selected namespace, followed by a list 
of each type it contains (recall from the previous issue, the term 
Type’ is a generic way to describe classes, interfaces, 
enumerations, structures and delegates). Next, click on the 
XmlTextReader class type link. As you can see ( Figure 2) you 
are provided with a definition and description of the type as 
well as the set of members it suppons. 


SSCU Namespace 

Meaxiiog In life 

System CodeDom. Compiler 

Sy.stem.CodeDom 

‘Code DOM is a very interesting icchnok^gy wliich allofts you to represent .NET axiing ranstmas in language 
neutral terms, and dymmicaOy generate and compile tlie persL^cd sou rev tt xlc. 

System. Collections. Spec ial ized 

System .Collections 

Tlie collection-centric namespaces provide numerous types (ArntyUsi. Hasttable. etc) that allow you to 
tiianage other types. 

System .ComponentModel 

Tliis namespace defines types that allow you to establish how your acstom compomnts should be treated at 
runtime (and possibly at design time). 

Sysiem.Configuration.AssembUes 

SvTitem.Coiifigurjtion 

As you will see latcn .NET ;cxsemb|icfi can be configiiied using XMl-lvjscti coTvflgunttion files, these 
namespaces defme types tliat allow' ycxi to interact watii tiiese files programmatically. 

System. Diagnostics .SymbolStore 

System. Diagnostics 

These are fairly low'-level name.spaces that define ty’pes that allow you to programmatically interact with 
tlebugging and iniclng dekils. 

Sy.stem .Globalization 

Here you will find types that help you deal with issues of intematianalizatiun. 

System. 10 LsolatedStorage 

System. 10 

.As you would guess, the System.tO-ceniric namespaces allow' ytju K? interact with your machine's 
directory structure. 

System, Net. Sockets 

System. Net 

Namespaces that allow you to prograjn against various network protocols. 

System. Reflection .Emit 

System,Reflection 

Tlie reflection namespaces allow you to dynamically investigate, and generate, types at runtime. 

System. Resoruce.s 

Ct)niain.s types which allow' you to embed resources tsudi as siring literals) into a given NET assembly. 

System. Ru ntinie .ConipilerSc rvi ce.s 

You will never care about tills namespace unless you atv interesitxi in building a .NET-aware compiler. 

System, Ru ntime ,1 nteropServ ices. Expa ntio 
System. Ru mime. I nteropSe nices 

Interoperability Ls the term u.sed to describe the process of communicating with native libraries from 
within a .NET ctxle ba.se. These nanie.spaces provide iype.s for sueli a task. 

System. Runtime.Remoling Activation 

System. Ru ntime. Remot ing. Channel s.ht i p 

System. Ru ntime. Rem oting, Cha nnelsTcp 

System. Ru ntime.Remoitng. Cha nncLs 

System. Runtime. Remoting. Contexts 

System. Ru ntime. Remoling. Li feti me 

System. Ru ntime.Remoting. Me.ssagi ng 
SysicmRuntime.Remoting.Mmclata.W3cXscl2fKU 
System. Runtime. Remoting. Metadata 

System. Runtime. Remoting.MetadataSer\ ices 
System. Runtime.Re moling. Proxies 

System. Ru ntinie. Remoting. Servlce.s 

System. Ru ntime. Remoting 

Hie SSCU provides numerous namespaces that aRow' you to liuild di.stiiiiuted systems using the .NET 
remoting amhitecture. 

System. Runtime, Sefialization.Formarters. I iinary 
Sy.stem. Runt i me. Seri alizationTormalters. Soap 
Sysiejn. Ru mime. Serialization. Formatters 

As you will see in later an ides, the .SSQJ provides a very sophisticated tbut .surprisingly simple) obfea 
serialization architecture. 

Sy .stem .Seen rity. Permissioas 

Sy stetn .Sccutit)'. Policy 

System .Secu rity. Piind pal 

System .Security 

As you would gue.ss. these name.spaces provide types that allow you to interact with die .NET security 
mcidel 

System Text. RegukrExpressions 

System. Text 

Regular expressions nianipulation namespaces also ship widi the S.SCLI, 

System.Tlireading 

Ihe Systeni.Direading namespiice defines types that allow you u? create and manipulate multi-threudetl applications, 

Sy,stem 

System is the root namesp;ice in the SSCLI class libraries. Here you will find a numlier of utility types CMath, 
TnieZonc, GC and so on), iniriasic <bta t)'pes (String, Int32. Boolean) and coninKin exoeptioas. 


SysteniXml. Sdiema 

System .Xml. Serialization 

System .Xml 

System.Xml. XPath 

System.Xml.Xsl 

Tlie SSCLI .supplies a number of namespaces that allow' you to generate, read and manipulate XML-based 

data. 


Table 3- The SSCU Base Class Libraries 
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listing L Defining shell aliases 



System .XmLXmlTextReader Class 


AnBinb4v: SysUm.Xfnldll 
Mamaspicfl'. Sylum.Stitnl 

Stimmary ij 

ReOTBsanAs a reader ttiat provides fast^ noo'CEiched., fdrwQrthOnl'y eEjcesx bi >(ML data. | 

^ ^ __ I 

ealT^^iMdjr ■ KMJJiMJaj. T1»1-LI aalaJa |l 

Riflinarhs 

KntrTefetPlaBdar pTMidtt forwird-ooly, nswl-only aoceu » a «™Bm of xML daw. trie ciurpni 
nodB Fol'ors to ttio node on wPtth Uw reader ts po^tlaned. The reader bs advanced mlng ary ot 
the read methodi and properties reftecE the value of the current node ^ 

. yj u !j ii| r « ^wj^t ; n^ . y^ t e rmtrape ^ yw^^^ ^ 

Figure 2 Reading up on the XmiTe::ciReader t^pe. 

1 would also greatly encourage you to add the ClassLibrary.hmiJ 
link to your browser's Favorites list. Over the lifetime of tliis series, 
I am assuming you will dive in and check out details I do not have 
die space to directly cover on your own accord. 

Sfiting Yolib a Development Environment 
At this point Fm sure you are ready to build ,NET 
applications using the SSCLI, however I have two final 
configuration settings, which while not required, will no doubt 
make your programming time more productive. The first tip is 
to define a set of shell aliases tliat allow you to quickly enable 
the SSCLI development environment (Listing 1). Using your 
text editor of choice, update your .teshre file with the following: 


* Change to SSCLI director', 
alias GoSscli 'cd "’/Web_DowiiloadE/CLl/sscli' 

* Change to SSCU and sonrci! the env.csh file 
alias DoSscli ’GoSscli: source env.csh' 

The First alias, GoSscli, can be typed into a Macintosh 
Terminal to quickly navigate to the directory containing the 
SSCLI (of course, your path may vaiy^ so modify accordingly ). 
The second alias, DoSscli, leverages die first alias to change to 
the SSCLI director and sources the envxsh file to establish the 
necessary environment variables. To be sure, when you intend 
to interact with any of the SSCLI command line tools (including 
the C# compiler) you must source this script or else contend 
widi the dreaded ''command not found" error. 

To test your shell updates, close your current Temiinal to 
commit the changes, open a new Terminal and execute the DaSscli 
command. You should see .sometliing like tlie following (listing 2): 

Lisiitig 2Tlie result of coniOMndiiig DoSscli 
Last login: Thti Oct 9 14:12:48 on tty pi 
Welcome to Darwin[ 

[Andrew’Troelsenfi’ComputerandrewtroelsenH OoSacli 
FaStchecked Environment 

Now^, type in the following command to see the list of 
options of the C# compiler: 

CSC -help 
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jFig«re JL Optio?is of the C# Compiler 


Configuring Project Builder 

The final shortcut you will most likely wish to do is to 
enable Project Builder to edit C# code files. This one is a no- 
brainer, simply create a new file with a ‘.cs file extension (or 
kx-tile one of the existing files provided by the SSCLI) and 
double click on the icon. From the resulting dialog box, simply 
choose Project Builder as the default application. 

You will notice that Projed Builder seems to recognize the 
syntax of C#, however don’t get your liopes up. While code 
comments and string literals are realized, C#-spectfic keyw'ords 
(such as ‘namespace’, Tising' or Tinsafe‘) do not receive such 
color-coding. Nevertheless, using Project Builder to edit code 
is an appealing alternative to command line editors such as vi or 
picQ (at least in my opinion!) 


The Basic Flow of SSCLI Development 
Excellent! If you are still with me, you are now all set to 
build your first ,NET application using the C# progmmining 
language. Regardless of which aspea of die SSCO you are 
exploring or which type of application you are constructing, you 
will tend to follow a fixed set of tasks: 

• Ensure you are working within a Terminal that has the SSCLI 
environment variables activated (thus the reason for the 
DoSscli alias). 

• Send your C# source code (as well as any number of 
command line aiguinents) into the C# compiler, esc. 

• Run your executable application using the Common 
Language Infrastructure Execution tool, clix. 

Lefs close this article with a complete example. 

Building youk First •NET Appucation 

Our goal in this section is to create a code library 
(myLib.dll) that Is consumed by a client application named 
myClient.exe. As briefly noted in the previous issue, .NET 
assemblies which end in a '.dll extension cannot be directly 
loaded by the aintime, but are rather loaded on demand by the 
client executable whicli request tlieir services (you1l see many 
more details regarding NE'E binaries and later in the series, 
so don’t sweat the details). 
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Creating MyLib.dll 

To begin, create a file named mylib.cs and author the 
following C# namespace definition (Listing 31: 

Listing 3: Your C#-based NET code librar)' 

using System: 

namespace MyLibrary 

[ 

public class Platformlnfo 

( 

H Static methods can be called 
// directly at the class level 
public static void PrintEnvInfo(3 
( 

// Use System. Envinmment b) show some stats, 
string info = 

stting.Format{"\n.NET version is: (0).", 

Environment.Version): 
info +“ 

string. Format ("\n3ysteiii Directory is: 1 0 I . 

Environment.SystemDirectory): 
info += string.Format 

('^\nMillisaconds since last boot: + 

Environment .TickCountJ : 

ConsoleiWriteLine("'Your System Information’"): 

ConsoiE,WriteLine(info): 

I 

) 

public class MyMathClass 

I 

// Non-Jitaijc memljers must be called at the 
// object level. 

public int AddNumbers(int x, int y) 

(return x + y;J 

public int SubNumbers(int x. int y) 

[return x - y:1 

public Int MultiNumbers(int x. int y) 
f return x ‘ y: 1 

public int DivideNumbers(int x^ int y) 
f return x / y:1 

public string WhlchlsBigger(int x, int y) 

I 

return string.Format("[0 I is bigger!". 

Math.Max(x. y)): 

} 


Surprisingly, this trivial nainef^pace definition illustrates a 
number of aspects of the C# language. First, recall from the 
previous article that the C# namespace keyword defines a 
conceptual boundary^ for a set of related types, while the using 
keyw^ord allow^s you to access types contained within another 
namespace. Here, the MyLibrary namespace defines two class 
types (in contrast to Java, a single C# source code file may define 
any number of types, wliose names do not need to map to the 
name of the physical source code file). 

The public Platfonninfo class defines a single static method 
named PrintEnvInfo(3. As you most likely already know, static 
type members can be called directly from the class level without 
the need to manually create an object in memory. The 
implementation of this method makes use of the static 
string.FormatO method to build a string containing various bits 
of infonnation regarding the current development machine. 
Recall from tlie previous installment of this series that the curly 
bracket syntax (e.g. lOf) signifies a placeholder for dynamic 
string building (slightly akin to tlie C printfO function). 

The MyMathCLass defines a set of instance level 
methods that manipulate two integer parameter types. As 


detailed in a future issue, the programming language 
defines a number of keywords which are shorthand 
notations for true blue types in the System namespace. 
Here, the 1nt' keyword represents a System Tnt32 
structure type. Next notice that the WhichIsBiggerO method 
leverages the static Math.MaxO method to return a stylized 
.string. Finally, in the case of each class implementation, 
notice that C# honors the C, C++, Objective C and Java style 
escape characters such as '\n\ 

Now, at the command line, compile this file into a .NET 
class library as so (Listing 4): 

Listing 4: Ctimpiling ^ C#-based ctxle library 

QSC /t;library mylih.ca 

Here, we are instructing the compiler to generate a class 
liLirary ^dll file (via /t:library) given an input file named mylib.cs. 
By default, the name of the *.dl! is based on the name of the first 
input file, thus upon successful compilation, you should have a 
new ,NET assembly named myLib.dll. 

Creating myClient.exe 

Now that we have a .NET ^.dll file, we need to create a 
client application to make use of it. Given tills, create another 
C# source code file named MyClient.es which contains the 
following namespace definition (Listing 5): 


Listing 5:The Oliased .NET client application. 

using System: 
using MyLibrary: 

namespace MyClientApp 
I 

public class HyApp 
I 

public static void Main(] 

I 

// Firsi show Environment info. 

Platfonninfo,PrintEnvInfo0: 

// Make a MyMaihClass type. 

MyMathCless m = new MyMethClassO ; 

Console,WriteLine(”* Fun with Numbers *"}: 

// Now enter a loop to perlbrm 
// simple math, 
do 
( 

int X ^ 0, y ^ 0: 

Console.WriteLine(’’Enter two numbers:"}; 

Console. Write ("Muaiber 1: : 

X = inr*Parse(Console.ReadLine(]): 

Console.Write["Number 2: "): 
y = int,Parse(Console.ReadLine(3): 

Console.WriteLinaCm.WbichlsEigger[x, y)): 

Console.WriteLinet"101 + [If t2l". 

X, y. m.AddNujiibers(x. y)): 

Console. WriteLine {10 J - [II = 12]’*. 

X, y, m,SubNumbers(x. y)); 

Console.WriteLine{"[0] * [1) “ i2]", 

X. y. m.MultiNumberstx. y3); 

Console.WriteLineC"iO] / [1| ^ i2]". 

Xp y. m.DividaNumbers[x, y)): 

Console.Write["Another round? "}; 

]while("n" != Console.ReadLineO 1 : 

I 

] 

[ 

Again, this simple example proves enlightening, First, given 
that tlie client application need.5 to make use of types located in 


No\tmber 2003 • MacTech 


Up and Running mm the SSCU 


71 









the System and MyLibrary namespaces, the first lines of code 
should be clear. 

The definition of MainO is important, in that MainO must be 
static and must ha%^e a capital (as C# is case sensitive). Beyond 
these restrictions however, the MainO method is quite flexible in 
that is may (or may not) take an array of strings to represent 
command line arguments, may (or may not) return an integer to 
the system, and miiy be declared public or private. Thus, any of 
the following MainC) methods are a-okay (listing 6): 

Listing 6: The various faces of MaiiiQ. 

public void Main (string [] atgs) [,..l 

public void MainO !-] 

public Int KainO f«.l 

public int Main(string[I args) 

private void Main {string [] args) f...] 

private void MainO l»d 

private int MainO 

private int Main(string[] args) (.J 

Here, our MainO method simply invokes the static 
Platformlnfo.PrintHnvinfo( l merhfxl and allocates an instance of 
the MyMathClass type via the new keyword. Alter this point, 
a do/while looii is entered to prompt the user for two numbers 
to pass to the various methods of MyMathClass. 

bust but not least, notice flow the textual data retrieved from 
System.Console.KeadLineO is transformed into a 'reaf numerical 
value using the static ParseO method of tlie System.lnt32 


#00 TelnetLauncher 


Bookmark and Launch your 
Telnot and SSH SGSsions 
Featuring: 

>Password storage 
>Auto minimize 
>Set text font and size 
>Specify terminal colors 
>Port forwarding 
>Terminal emulation 


This and much more available from... 

piDog Software 

SimpleKeys - piPop - DockSwap “ ScreeiiSliot Pius 

www.pidog.com Info@pidog.com 


Structure as seen in Listing 7 (remember! The C# hnt' keyword 
is nothing more than a shorthand notation for declaring a 
System.Int32 type): 

Listing 7:The and System.lat32 relationship. 
// x' and are really of type Systeni.Int32! 
int X = Oh y = 0: 

Console,WriteLine("Enter tvo numbers:"): 

Console.Write("Ltumber 1: "); 

// System.Int32 defines a static ParseO method. 

X ^ int.Parse(Console.ReadLine()): 

Console,Write("Number 2: ") : 
y = Int,Parse(Console.ReadLine ())1 

To compile tliis file into an executable binary requires the 
following command set (Listing 8): 

Listing 8: Bui Idi ng a .C* *-based executable. 
CSC /t:exe /r:TnyLib ,dll HyClient,cs 

Here, we are instructing tlie compiler to generate an 
execTitable File (via /i:exe) which references tyj:ies contained witlim 
myUb.tlil (via /r: my Lib .dll) given the input file mimed MyClient.es. 

Observing the Fruits of your Labor 

Unlike a native Macintosh application, you cannot simply 
double dick on MyClient.exe to launch the client liinary. When 
working within the confines of ihe SSCIJ, you need to bootstrap 
.NET executable assemblies using the CLl Execution utility 
(clLX,exe) a.s seen in Listing 9: 

LisUng ^).M\ good things do tome, 

clix royclient 

Once you have done so, you can manipulate integers to 
your hearts content (Figure 4). 

9 © 6 Mv Ultra TermtnjU - icsh - iO^xia _ " 


? 

Figure 4 . Your/irsi .NE 7 'Applkation 


Wrap Up 

So then! At this point you (hopefully) have succeeded in 
your installation of the 5SCL1 and the first compilation of your 
-NET lifestyle. Over the course of this issue, you have been 
provided with an overview of various subfolders within the 
/sscli root directory, the use of the HTML-based help system and 
select command line tools. In the next issue, you will come to 
know the details of the compiler, investigate several of the 
supplied sample applications and forge ahead with your 
understanding of C#. Until next month, happy hacking! 
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Adobe Press Knows CS 

After all, our best-selling Adobe 
Press titles are written by the 
software experts at Adobe. 
Check out our all-new lineup of 
CS titles today! 

Adobe Illustrator CS Idea Kit 
By Barbara Mulligan and Jerome 
Holder 

0-321-20544-8 • $19.99 

Adobe Illustrator CS Classroom 
in a Book 

By Adobe Creative Team 
0-321-19380-6 • $45.00 


Idea Kit 




Adobe InDesign CS Classroom 





Coming in December! 
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in a Book 

By Adobe Creative Team 
0-321-19377-6 • $45.00 

Adobe Master Class: Photoshop 
11;: Compositing with John Lund 

By John Lund and Pamela Pfjffner 
- ^0-321-20545-6 • $50.00 


Adobe Photoshop 
Book 

y rtdobe Creative Team 
U-321-19375-X* $45.00 


Save up to 30%f Become a Peachpit Club Member today! 

Enjoy 10% off all books every day at peachpitcom, earn an 
additional 10% discount a$ a Peachpit Club fVIembec and save 
10% on top of that with this one-tirh^coupon! Simply go to ^ 
www.peachptt.com/mactech 1103 and enter coupon code 
EM-N3AA-MTMF at checkout Its that easy! 



































REVIEWS 


By Chris Kilbourn 

VisualRoute 


Java tool for graphically displaying 
traceroute information 

DESCRIPnON 

VisualRoute 7.1 is a Java application that provides graphical 
traceroute, real-time latency, and ping data graphed in a tabular 
and world map format. It also provides limited whois and 
nslookup feamres that are available when drilling down on any 
displayed data. VisualRoute also may !>e operated via a Java and 
JavaScript-enabled browser, as it includes its own built-in web 
server, allowing you to query die application from across the 
network. 

Included in the VisualRoute application is an extensive 
database of IP addre.ss and geographic information diat allows it 
to display traceraute.s on die global map. VisualRoute also 
suggests possible causes for common connectivity issues, which 
may be helpful wlien diagnosing netw^ork Issues. 

Users unfamiliar with the command-line use of traceroute, 
ping, mtr, whois or nslookup will probably get the most mileage 
our of VisualRoute, It provides a GUI-driven interface fur diese 
commands without having to read the man pages. Network and 
system administrators who need to explain why, "the Internet is 
down'' to users unfamiliar witli Internet routing and topology 
will appreciate the map that you can point to and say, "The 
problem is there, not here." 

FIRST BLUSH 

Installation is straighrforw^ard from a Stuffit Archive to a 
standard package installer, except for a minor glitch that I liad 
which required me to upgrade to Stuffit 7,0.3 from the 7.0 
version I was running. As far as I could tell, liie only files 
installed are the VisualRoute application itself, two htnil files and 
a gif The system I tested the product on was a 667mliz TiBook 
with 768MB of RAM running Mac OS X iO.2.6. 

Upon first launch of the program asks you to select the 
language you wish to use. Language choices are English, French, 
German, Spanish, Italian, Swedish, Portuguese, Czech and 
Dutch, 

VisualRoute starts in Simple Mode, and you are presented 
with a world map and an Address field where you can type in a 


host address, (i.e. - www.forest.net,) or an [P address to begin a 
traceroute. Advanced mode provides a tabular readout of 
traceroute data along with the world map. I found that while the 
map was nice eye candy, 1 tended to work with the tabular 
information more than die map information. VisualRoute does 
provide options to display information in ASCII fonnat in a text 
editor. 

One of the first things ihai struck me when using the 
application was die lack of keyboard commands for menu items. 
This likely has to do with the fact tiiat the entire application is 
written in Java, but it was odd, and was a persistent irritation 
w'hen driving the program. System-level window controls were 
still available via key commands. 

TRACEROUTE 

The core of the application is its traceroute function. Typing 
in a hostname or an IP address, it begins to collect and display a 
variety of data about the network between your machine and the 
destination host. 

For those unfamiliar witfi it, traceroute is a low-level 
network diagnostic tool that udlizes ICMP (Internet Control 
Me.ssage Protocol) packets. ICMP is used for error control, test 
packets, packet redirection and other informational messages 
alKJut network transport of IP. Since ICMP has die potential to 
provide a variety of infuniiaiion about remote networks by 
sending off an ICMP packet and wailing Ibr a response, as well 
as be used in certain network attacks, more and more internet 
networks are beginning to filter ICMP packets on the edges of 
iheir networks. 

Traceroute literally traces the network path, hop by liop, 
from your computer to a remote liosl. It provides the IP address 
of each hop, the node name, and the time in milliseconds from 
that node to yours. Running a traceroute allows you to discover 
three critical pieces of infomiation aliout the network path: how 
many hops it is from your computer to the destination, if there is 
congestion at any of the hops, and if there is any packet loss 
along the way (The terms hop, node, and router may be used 
interchangeably). 

llie more hops in a network path, the longer the Transfer 
times will be, in general. Each time a packet has to be prexessed 
by a router, it adds a small delay to the transfer. Hop counLs from 
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two to roughly sixteen are considered average. Traceroute 
displays each hop on a numbered line, so calculating hop count 
is very easy. 

Congestion manifests itself in traceroute by a hop that has a 
high time value, usually considered to he above 250 
milliseconds. Hops with time values of above 250 milliseconds 
generally mean that the router In question is very busy and 
queueing packets for processing, adding network latency to that 
hop. 

Packet loss in traditional command-line traceroute is 
displayed witlt stars (sometimes referred to as ^starring out.') This 
means that ICMP packets sent to tliat node are not l>eing 
returned, Wlien this happens but you can still reach the ultimate 
destination, it usually means that the router in question is so 
overburdened that its queue is full, and it is dropping or 
rejecting new packets for processing. If the traceroute ends 
before ilie destination, it usually indicates that the network path 
has been severed. This could be due to any number of man¬ 
made or natural disasters such as power outage, fiber cut, router 
misconfiguration or the bane of network administrators the 
world over: telco incompetence* 

VisualRoute provides information in its traceroute display in 
addition to the traditional hop count, IP address, host name and 
response time. For your viewing and infomiadon pleasure, it 
provides a packet loss percentage, its best guess at the location 
of a node, the time zone that node resides in, a time graph with 
current time plotted against minimum and maximum titne 
values, and VisualRoute’s best guess as to the network 
ownership of each hop. 


End-user consumer networks, AOL, Earthlink, cable modem 
prcwiders and DSL providers tiften filter ICMP traffic. Many 
corporate firewalls are also programmed to refuse to pass iCMP 
traffic. Since traceroute and ping require ICMP to flow, if your 
network provider filters ICMP, VisualRoute will be of little use in 
providing much traceroute information unless you can run the 
application from an unfiltered network connection, 

USING VISUALROUTE S TRACEROUTE 

Using VisualRoute is simple. You type in a hostname or IP 
address, hit return, and it automatically begins to map the 
traceroute on the world map, and build a standard traceroute 
table with current packet loss and transmission time statistics. 




MakeDiawingFunonOSX 


Introducing EazyDraw-the fun, easy-to-use Mac DS X 
design tool that lets you draw like e prol Now you 
don't need to be a graphic artist to create great 
illustrations. EazyDraw's vector-based graphics and 
editing capabilitiBs make it easy to create technical 
diagrams, flow charts, and business Gommunications 
as well as commercial line art jllustrations and graphic 
etements for application software and web design. 

Learn more about EazyD raw today! Get big savings 
buying direct from our online store. Visit us at 

www.eazydraw.com 

(That's easy with a Z). 

C 2003- Dekoira OpliDS. LLC. AJt rights reserved. 

EazyDraw and tha 'boj( dt tPdis' Bre Pt Pe^cjOfra Optics. UjC. 

Mac and Buitt for OS X ar'S trademarks of Computer. Inc. 
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VisualRoute keeps track of previously traced destinations 
from a handy pop-up menu and allows you to sort the list by 
name or most recently visited. It also provides the IP addresses 
of die hosts to the side in a pop-up menu. 

One of the things 1 enjoyed about VisualRoute's traceroute 
is its analysis and summary information of the destinadon host. 
Above the world map, VisualRoute informs you what type of 
server the host is and what software it is running. This feature 
can be very helpful when tracking down web compatibility 
issues tetween browser and host or to sec if your own servers 
are publishing OS information they should not be. 

The application wall also provide you with suggested 
connectivity issues if it encounters a problem during a 
traceroute. These messages will help you determine issues from 
ICMP traffic being filtered somewhere along the traceroute path 
to DNS misconfiguration issues. 

Double-clicking on a host from the traceroute pane wall 
launch a Hoating w'indow with IP addres,s information pulled 
from AKIN, RIPE or APNIC’s, (the registration authorities that 
delegate IP addresses for the Western Hemispliere, 
Europe/Af'rica and Asia, respectively,) IP registry databases. 

Any information provided that is located in other registries, 
(registered host addre.sses, contact handles, etc.) is hyperlinked 
to allow you to continue to drill dow n in regi.stry databases. 'Iliis 
is an incredibly useful feature that allows you to follow' the trail 
of authority for an address range or host when iiy^ing to track 
dowm a netw^ork administrator to tell them to patch their serv'ers 
or w^hen hunting for spammer networks to block. 

These floating information window^s also provide a button 
to automatically copy information into a text document, w^hich 
can then be easily cut and pasted elsewhere. 

A nifty feature of VisualRoute is its ability to function a.s a 
stand-alone w^eb ser\^er to provide traceroute information. This 
is especially helpful if your network filters ICMP and has a DM2 
network between the Internet and your internal network. 



All the features of the stand-alone server are available via 
the web interface. Using VisualRoute in the web server mode is 
a great way to enable users on your network to perform their 
own traceroutes. 


YOU CAN’T GET THERE FROM HERE 

In my opinion, one of VisualRoute's most touted features, 
its database and map of Internet host addresses, is also a subtle 
Achilles heel Let's examine a traceroute to a Mongolian wub 
serv^er as an example: 



If a user, client or pointy-haired lioss of mine w^as 
complaining about access times to this .server, 1 w-uuld show' 
them the map and the traceroute output times and tell them that 
it takes a long time to gel packets back and forth from inner 
Mongolia, 'fhe tximplainer thus pacified, I would then turn to 
ntore pressing matters like reading SlashdoL 

However, taking a close look at and comparing 
VisualRoute's map versus a relief map of Mongolia indicates that 
VisualRoute thinks that this server is in the middle of a high 
desert. I sincerely doiil>i that server is where it is mapped. We 
all know that data center operators fight a constant battle with 
heat, l^ut placing servers in such a low-humidit>^ environment 
introduce,s other issues best left for another article. In short, the 
server is probably in I long Kong or maybe Ulan Bator based on 
round-trip times. 

Before somec}ne cries. Ttiuir that the example is extreme, 
and that VisualRoute should be excused from a detailed 
mapping of Mongolian hosts, (a debatable point either w^ay), 
allow' me to explain why I chose this example and the 
ramificaiions of relying solely on single-sourced data Ibr host 
location informarion. 

One of the greatest things alxrut ilte Internet is its resiliency 
in utilizing distributed services. This di.stnbution of services is 
built in at the protocol level and is a core feature. Current (and 
some past,) routing technology has the ability to tunnel, VPN, 
route or otherwise allow for distribution of IP addresses in non¬ 
contiguous blocksS on widely geographically separated networks. 

When ARIN, RIPE or APNIC assign IP address space to 
organizations, they place no restrictions on where in the world 
those IP addresses may lie used. Only the requesting 
organization s mailing address must be located in the region for 
which IP address space is requested. 
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A great example is an employee traveliiig on iniernational 
business who remotely connects to the corporate network via a 
dial-in server and is assigned an IP address via DHCP. 
Performing a traceroute to their laptop may show increased 
round trip times due to the distances involved, and the IP 
addres.s being used is traced back to the corpoi ate headquaners 
address as listed in the IP registry ckitabase. 

VisuaLRotite, or any other program for that matter, would 
map this dial-in laptop user as at the corporate location, even 
though they could lie anyw^here in the world. Examining all 
available IP address and netw'ork information, you have no way 
to discern if that host is at corporate headquarters or somewhere 
on the road. The only way to be sure would be to call the user 
and ask them where they are. 

As you can see, you cannot rely 100% upon tlie geographic 
host information pjovided in databases and derived from 
analyzing I? packets. When examining VisualRoLiters Lraceroute 
maps, you should be aware of this issue, and take legation 
information for hosts that you do not know^ about with a small 
to large grain of salt depending on your need for accurate host 
location inforniaiion. 

VisualRoute does have an exlen^sive gec)gmphic database, and 
it allows you to add c^r correct network and host information. 



WHY CROSS-PIATFORM CAN BE A FOUR LETTER WORD 

VisualRoute is a Java application and as with other cross- 
platform Java applications on the Macintosh, it shows. My two 
big beefs are that it ignores human user interface guidelines 
by forcing the user to go to the mouse for just about 
everything, and by ignoring Macintosh inrer-applicaiion 
communications by using helper applications to pass data 
from VisualRoute to other applications. 

Most inexplicable is the complete lack of keyboard 
commands w'ithin the application. I am not a Java 
programmer, but a quick web search brought up some 
examples of command-key coding in Java, with the caveat 
that with the continuing Balkanization of tools and 


technologies between platforms, implementing command 
keys can be difficult. 

While annoying, 1 talked myself into believing I was just 
running a very old Macintosh application that did not have key 
commands. Mousing around so much really got to be frustrating 
when drilling down on registry lookups and in navigating the 
application's features. 

VisualRoute has two features tliat cause it to interact with 
external applications: jumping to a web page and copying 
looked Lip infonnation to a text editor, I can appreciate that 
being a Java application, it might he easier to create a platform- 
specific lielper application to launch a web browser or a text 
editor, but 1 have a hard lime excusing the fact that VisualRoute 
does this ever>' lime you go to a web page or paste infonnation 
to a text editor. 

For example: 



Do not adjust your magazine, the image is correct. Tliis is, 
in tw'o words, sloppy coding. It took me almost as long to quit 
all those helper applications as it did for me to use VisualRoute 
to track down a spam source. 

Here's hoping thai a future revision of VisualRoute will fix 
these two glaring issues. 

TOE BOTTOM LINE 

VisualRoute 7.1 ls a Java graphical traceroute utility application 
tiiat provides real-time, graphed displays of traffic information 
coupled witli a geograpliic map display of die nemork path. iLs 
core functiomtlity Ls equivalent to command-line ttxils sucli as 
traceroute, dig, aslcxikup, ping and mtr, VisualRoute also provides 
a web server mode allowing for remote use or for use on a DMZ 
network that is not blocking ICMP traffic.. Additional features 
include mail server MX record kx)kups and die ability to drill down 
on DNS and IP address registry information for hosts and addresses. 
While useful for hcAh ne%v and seasoned nemork administrators 
performing network diagnostics, the application is hampered by its 
lack of key^board commands and its proclivity to launch multiple 
instances of .supporting applications. 
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BOOK REVIEW 


By Ron Davis 


Cocoa Recipes for Mac OS X 


If you aren't nei^’ to the Macintosh and having prograiiinied 
before there was Cocoa and then you decided early in the history of 
MacOS X you were going to learn Cocoa, youVe probably l^een to 
StepWise.com and seen die Vennont Recij:>es. These were a series 
of tutorials on how to build OpenStep applicuioiis. Iliey were the 
tutorials you first learned with l:)ecaLise Apple had no tutorials, and 
there were no books on the siibjea at die time. Now these tutori^iLs 
have a !xx>k of their own. 'Tliey've l-ieen updited and fleslied {>ut by 
Bill Cheesman and colleaed in the new Ixxik from Pe^ichpit Press, 
Cf.)Coa Recipes JorMac OS X: Ihe Vermont Recljxis. 

If you are new to die Mac, or are just now' deciding to leave die 
dark ages and learn some CcK'oa, tills liook provides a a)ncrete set 
of examples of how to make Cocoa applications. Apple's 
diXLimentation has improved greatly, liut if you want a more 
complete step-by-step approach to develfjping a complete Gx:oa 
application, tills bcxik Is diere to provide it for you. 

Tlie first question you’ll probably ask is whether you should 
buy the bcxik given many paits of it were on the web. Well the 
Vermont Recipes were based on OpenStep and even when Coam 
first came out there were differences. Now' those diirerent:es are 
even gre^tter. The Ixxik is the updated version. 

The bfxik starts out with .some sliort intrtxluaojy^ cha[Xers 
w^here it discusses the [liiilasophy tT the btxik. Tlie author wants to 
go through a real world application and liuild it a layer at a time. 
He's not trying to cover every^ aspea of Cocoa, every call, ever\' AI^I, 
lastead he is covering the things you really use. 

They claim the lxx)k isn't a reference Ixxik, but it is more the 
kind of Ixxik you open when you need to do a ixiiticular thing and 
Icx)k for an example. Sitting dow'ii and going througli the Ixxjk one 
chapter after anodier will teach you a lot about progntmming in 
Cocoa, but you can still get value out of it liy pulling it olY die shelf 
wlien you want to find out how' to rnake a contextual menu or put 
data in a keyed archive. 

Tile Ixxik is organized into seven seciitins: Building An 
Appliaidon, User Controls, Data Storage, Mcnu.s, Windows, Additional 
Applicauon Features, and Working ^Itli Mac OS X 10.2. Each section 
is broken up into recipes. Some sections liave a lot of recipes like User 
Controls w'itli nine. Some widi only one like Data Stomge. 

Eiicli recipe covers a large topic in the application deveiopment 
cycle. Each recipie is broken up into steps. A step is one set of things 
you need to add to accomplish die overall recipe. Each step is 
broken down into sul>steps, which Is where the actual axle Is. 

There is a lot of explanation in each step, Each sub-step tells 
you wliat you need to do and dien shows you the code. Then the 


text explains wliiit eacli piece of code does and means. There are 
sideliais tliroughout die Ixxik diat cover, not the code, but the 
technology', The first recipe contains sidebars on Model-View^- 
ControUer and Dictionaries among oiliers. 

The first recipe cieates a simple multi-dixmment applic::adon 
complete with saving, icoas and deployment builds. It is an 
intrcxluction to using Project Builder and Interface Builder Ifs also 
149 p'dges long. This Ixxik is long. Wliile it covers a lot, most of it is 
the basic .stuff. The book jus! covers all of die Ixisics. 

The second recipe builds on die first adding a window widi a 
bunch of buttons. While a stimewhat contrived example, it Is common 
to have to add controls as the next step in die developing a document 
app. Personally 1 w^oukl have created a Preference Window. Tliese 
alw^ays rec|iiire a bunch of controls. As diis section on user controls 
continues more and mow controls are added to tlie window. 
Ultimately every possible control is covered Ix^fore the seaion ends. 

After tile really long section on controls there Ls a really short 
one covering keyed arcliiving. 'llien menus get covered. Not just 
menus in the menu bar, but ctmtexmal menus and dock menus. Tlie 
filth .section covets windows adding drawers, alerts and dialogs. User 
pmfcTences and help Are covered in the la.st section before 10.2 only 
features. Tlie sectkin on 10.2 only features tells how to test for a 
feature and maintain backw'ards compatibility. 

So w'liat is missing? There is no discussion of toolbars, which 1 
expected w ficn talking alxiul meniLS. Also there is no discussion of 
AppleScript or AppleEvenLs. And while table vic^s are covered 
under user contjols, there is no discussion of tlie outline view variant. 
But iJie lKK)k is already 750 page^ long; you can't cover everything. 

Of course like all computer Ixxiks Oils one is tktted almost as 
stx)n as it gets released. Given tlie major changes that Father and 
Xcode are bringing, some of die tilings in the Ixxik are already in 
need of changes. Xcode brings a different development 
environment, and tile intrcxluction of Bindings fundamentally 
changes how Ccxoa apps are written and .structured. But in order to 
use bindings tlie developer Ls forced to use Pather only, whidi will 
limit the adoption of bindings in die near term. 

Overall this is a great book for Ix^ginners and intemiediate 
Gx'oa programmers. It is w'ell written, walking you through 
everything you need to know. Advanced programmer proliabiy 
know everything m ibis hook, but still might lienefit from Iwing it 
around to use as a refresher when tliey need to remember how to 
do something they don't do very often like dock menus. 

hTtp://www. stepwise.com/Artides/VermontRedpes/index.html 
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